Get Provative Set

This article explains how to get a probative set from a transaction through the REST API. The probative set is a document (pdf), which contains all the evidence of a specific transaction (photo, geolocation and etc). Such evidence can be used to ensure the authenticity of the transaction.

Make a GETrequest to the /credit/transactions/{transaction_id}/probative endpoint.

With a valid access token, make a request to the (GET/credit/transactions/{transaction_id}/probative) endpoint, sending the following parameters.

If everything is right in the request, the response is a JSON with the temporary link to probative set, as follows:

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

Important

The link returned to the probative set is valid for five minutes after being obtained. This link should not be saved, only used to download the probative set.

It is only possible to generate the probative set of approved transactions.

If an error occurs, the response is a JSON with the error and the error code:

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

The following is a list of possible errors returned by the service:

HTTP Code	Code	Description	Reason
400	40004	transaction id is invalid	The transaction id is invalid (format)
400	40009	transaction status is invalid	The transaction status is invalid (not allowed for generating probative set)
403	40301	not allowed	The user does not have permission to perform such an action.
404	40401	transaction not found	Transaction not found
500	50001	internal error	Internal service failure

Any concerns?

Missing something or still need help? If you are already a customer or partner, you can contact us through the Help Center.