> ## 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 una cuenta receptora de forma síncrona > Valida una cuenta receptora de forma síncrona y devuelve un envoltorio {resultado, motivo, motivoComplemento, dtHrValidacao} sin excepción en cada resultado (HTTP 200 incluso para una cuenta inválida). Ejecuta las verificaciones de duplicado de 24 h de la conciliación + de divergencia del pagador, el tratamiento especial de Bacen (ISPB 99999) y la verificación de consistencia cuenta-documento. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml POST /v1/webhooks/validates openapi: 3.0.3 info: title: Plugin BR Pix Directo - API completa description: > API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. 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 una cuenta receptora de forma síncrona description: >- Valida una cuenta receptora de forma síncrona y devuelve un envoltorio {resultado, motivo, motivoComplemento, dtHrValidacao} sin excepción en cada resultado (HTTP 200 incluso para una cuenta inválida). Ejecuta las verificaciones de duplicado de 24 h de la conciliación + de divergencia del pagador, el tratamiento especial de Bacen (ISPB 99999) y la verificación de consistencia cuenta-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: Error components: schemas: ValidateAccountBody: additionalProperties: false properties: bankIdPss: description: ISPB del participante PSS de Saque/troco (una cadena v5.5.0). type: string creditoDevolucao: $ref: '#/components/schemas/ReturnCredit' creditoOrdemPagamento: $ref: '#/components/schemas/CreditMoneyOrder' dtHrOp: description: Marca de tiempo de la operación (ISO-8601). type: string finalidade: description: Finalidad (eFinality). format: int64 type: integer idConciliacaoRecebedor: description: Id de conciliación del beneficiario. type: string infEntreClientes: description: Información entre clientes de texto libre. type: string modalidadeAgente: description: Modalidad del agente (eModalityAgent). format: int64 type: integer pagador: $ref: '#/components/schemas/PartyBlock' prioridadePagamento: description: Prioridad del pago. format: int64 type: integer recebedor: $ref: '#/components/schemas/PartyBlock' tpIniciacao: description: Tipo de iniciación (eStartupType). format: int64 type: integer tpPrioridadePagamento: description: Tipo de prioridad del pago. format: int64 type: integer valor: description: Monto en reales (un número JSON). format: double type: number vlrDetalhe: description: Entradas de detalle de valores opcionales. items: $ref: '#/components/schemas/ValueDetailBlock' type: array nullable: true required: - pagador - recebedor - dtHrOp - valor type: object ValidateAccountResponse: additionalProperties: false properties: dtHrValidacao: description: Marca de tiempo de la validación (ISO-8601, UTC). type: string motivo: description: Código de motivo en un resultado inválido (BE17/AC03/BE01). type: string motivoComplemento: description: >- Complemento del motivo legible para humanos en un resultado inválido. type: string resultado: description: Resultado de la validación (0=Inválido, 1=Válido). format: int64 type: integer required: - resultado - dtHrValidacao type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio emisor (formato: -NNNN). type: string detail: description: >- Una explicación legible para humanos específica de esta ocurrencia del problema. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. format: uri type: string status: description: Código de estado HTTP format: int64 type: integer title: description: >- Un resumen breve y legible para humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. type: string type: default: about:blank description: >- Una referencia URI a la documentación legible para humanos del error. format: uri type: string type: object ReturnCredit: additionalProperties: false properties: codigoDevolucao: description: Código de motivo de retorno (eRefundCode). type: string endToEndIdDevolucao: description: End-to-end id de retorno. type: string endToEndIdOriginal: description: End-to-end id del CASH_OUT original. type: string type: object CreditMoneyOrder: additionalProperties: false properties: chave: description: La clave Pix. type: string endToEndId: description: End-to-end id de la orden de pago. type: string idConciliacaoRecebedor: description: >- Id de conciliación del beneficiario (la clave de verificación de duplicados de 24 h). type: string type: object PartyBlock: additionalProperties: false properties: cpfCnpj: description: CPF/CNPJ del documento del titular (una cadena v5.5.0). type: string ispb: description: ISPB del participante (una cadena v5.5.0). type: string nome: description: Nombre del titular. type: string nrAgencia: description: >- Número de agencia/sucursal (la fuente de la agencia del participante). type: string nrConta: description: Número de cuenta (NUNCA se usa como agencia). type: string tpConta: description: 'Tipo de cuenta (eAccountType: 0=corriente).' format: int64 type: integer tpPessoa: description: 'Tipo de persona (ePersonType: 0=física, 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 detalle de valor. format: int64 type: integer vlrTarifaDinheiroCompra: description: Monto de la tarifa de compra en efectivo (reales). format: double type: number required: - vlrTarifaDinheiroCompra - tipo type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > 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). ````