Obter conjunto probatório da transação

Este guia explica como obter o conjunto probatório de uma transação através da API REST. O conjunto probatório é um documento (pdf), que contém todas as evidências de uma transação específica (foto, geolocalização, etc). Tais evidências podem ser utilizadas para garantir a autenticidade da transação.

Faça uma requisição GET para o endpoint /credit/transactions/{transaction_id}/probative

Com o token de acesso válido, faça uma requisição para o endpoint (GET/credit/transactions/{transaction_id}/probative).

Com tudo certo na requisição, a resposta de retorno é um JSON contendo o link temporário do conjunto probatório como a seguir:

{
  "link": "https://unico.io/probative.pdf",
}

Importante

O link retornado para conjunto probatório tem validade de cinco minutos após a obtenção. Então é importante que esse link não seja salvo, e sim usado para efetuar o download do conjunto probatório

Só é possível gerar o conjunto probatório de transações aprovadas.

Caso algum erro aconteça, a resposta de retorno é um JSON contendo o erro e o código do erro:

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

A seguir uma lista dos possíveis erros retornados pelo serviço:

HTTP Code	Código	Descrição	Motivo
400	40004	transaction id is invalid	O id da transação é inválido (formato)
400	40009	transaction status is invalid	O status da transação é inválido (não permitido para geração do conjunto probatório)
403	40301	not allowed	O usuário não tem permissão para fazer tal ação
404	40401	transaction not found	A transação não foi encontrada
500	50001	internal error	Falha interna no serviço

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.