1. Callback de Certificadora
QTrust
  • QTrust API - Docs
    • Guia de Início — API QTrust
    • Primeiros Passos e Autenticação
    • Modos de Autenticação
    • Credenciais e Suporte
    • Compressão gzip
    • Sua Primeira Requisição
  • QTrust API - REST
    • Retorno Bancário
      • Importa um arquivo de retorno bancário
    • Consulta de Operações
      • Consulta a situação das operações de uma data
      • Consulta os recebíveis de uma operação pelo nome do arquivo
      • Consulta paginada dos recebíveis de uma operação
    • Callback de Certificadora
      • Recebe o retorno de certificação da QCertifica
        POST
    • Raiz
    • Esquemas
      • ExceptionResponseError
      • ExceptionResponse
      • FromtisError
      • ImportBankReturnRequest
      • OperacaoSituacao
      • OperacaoDetalheItem
  • QTrust API - SOAP
    • Importação CNAB
      • Importa um arquivo de remessa CNAB
      • WSDL da operação
    • Aprovação de Operação
      • Aprova a operação pela consultoria
      • WSDL da operação
      • Aprova a operação pela consultoria informando a conta corrente
      • WSDL da operação
      • Aprova a operação pela gestora
      • WSDL da operação
    • Relatórios
      • Agenda a geração do relatório de estoque
      • WSDL da operação
      • Agenda a geração do relatório de liquidados e baixados
      • WSDL da operação
      • Consulta o status do relatório de estoque agendado
      • WSDL da operação
      • Baixa o arquivo do relatório de estoque
      • WSDL da operação
    • Cedente
      • Consulta as contas correntes de um cedente no fundo
      • WSDL da operação
      • Cadastra cedentes aprovados no fundo
      • WSDL da operação
  1. Callback de Certificadora

Recebe o retorno de certificação da QCertifica

POST
/v2/certifier-callback/qcertifica
Endpoint que a QCertifica chama para devolver o desfecho de uma aquisição ou
certificação digital.
Corpo: XML, com ou sem envelope SOAP. A raiz aceita é retornoAquisicao ou
retornoCertificacaoDigital — o parser localiza qualquer uma das duas em
qualquer profundidade e ignora prefixos de namespace. Corpo sem nenhuma delas é
tratado como payload não reconhecido.
Autenticação: não há esquema fixo. Cada certificadora pode cadastrar um par
header/token (DS_HEADER_AUTH_CALLBACK e DS_TOKEN_AUTH_CALLBACK); quando
ambos estão preenchidos, o callback precisa trazer aquele header com aquele
valor exato, e responde 401 caso contrário. Com qualquer um dos dois em branco o
callback é aceito anonimamente. Por isso não há nome de header a documentar aqui
— consulte o cadastro da certificadora.
Resposta: sempre um envelope SOAP retornoResponse, com text/xml, inclusive
nos casos de erro. É o par status/codigo do corpo que distingue sucesso de
falha, junto do status HTTP.

Requisição

Parâmetros Bodytext/xmlNecessário

Examples

Respostas

🟢200
text/xml
Retorno recebido e processado.
Bodytext/xml

🟠401
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https://{dominio-cliente}-ws.qtrust.com.br/v2/certifier-callback/qcertifica' \
--header 'Content-Type: text/xml' \
--data '<?xml version="1.0" encoding="UTF-8"?>
<retornoAquisicao id="123456">
  <retornoProcessamento>
    <status>0</status>
  </retornoProcessamento>
  <operacao>
    <termoCessao>termo-cessao-123456.pdf</termoCessao>
    <titulos>
      <titulo>
        <numero>000123</numero>
        <nomePkcs7>titulo-000123.p7s</nomePkcs7>
      </titulo>
    </titulos>
  </operacao>
</retornoAquisicao>'
Response Response Example
200 - Sucesso
<?xml version="1.0" encoding="utf-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:retornoResponse xmlns:ns2="http://v2.webservices.portal.fidc.fromtis.com.br/">
      <return>
        <status>00</status>
        <erros>
          <erro codigo="00">
            <mensagem>Retorno Recebido com sucesso.</mensagem>
          </erro>
        </erros>
      </return>
    </ns2:retornoResponse>
  </S:Body>
</S:Envelope>
Modificado em 2026-09-11 17:35:01
Página anterior
Consulta paginada dos recebíveis de uma operação
Próxima página
ExceptionResponseError
Built with