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",
}

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


Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.

Last updated

Copyright © 2024 unico. All rights reserved.