All pages
Powered by GitBook
1 of 1

Chargeback


Before you begin


Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about how to generate an access token here.

Endpionts:

  • UAT: https://transactions.transactional.uat.unico.app/api/public/v1;

  • Production: https://transactions.transactional.unico.app/api/public/v1. We

Chargeback Analysis Request


Request chargeback review

post

Endpoint to request a chargeback review for a specified transaction.

Path parameters
transaction_idstringRequired

Transaction ID to be submitted for chargeback.

Header parameters
AuthorizationstringRequired

A valid access token. The value must be sent in the format Bearer {token}.

Body
datetimestring · date-timeRequired

Chargeback request date and time in ISO 8601 format.

Example: 2023-01-05T03:00:00.000Z
namestringRequired

Name of the requestor.

Example: USER_NAME
reasonstringRequired

Reason for the chargeback request.

Example: REQUEST_REASON
observationstringOptional

General observations about the request.

Example: GENERAL_OBSERVATIONS
Responses
200
Chargeback request successful.
application/json
400
Bad request (invalid data).
application/json
403
Access forbidden (invalid token or insufficient permissions).
application/json
404
Transaction not found.
application/json
500
Internal server error.
application/json
post
POST /api/public/v1/credit/transactions/{transaction_id}/chargeback HTTP/1.1
Host: transactions.transactional.uat.unico.app
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 231

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": {
    "key": "cpf",
    "value": "USER_CPF"
  },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS",
  "documents": [
    {
      "label": "FILE_NAME",
      "data": "JVBERi0xLjQKMSAwI=="
    }
  ]
}
{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

Check the status of the chargeback analysis


Get chargeback review status

get

Endpoint to check the status of a specific chargeback for a transaction.

Path parameters
transaction_idstringRequired

Transaction ID associated with the chargeback.

chargeback_idstringRequired

Chargeback ID to be retrieved.

Header parameters
AuthorizationstringRequired

A valid access token. The value must be sent in the format Bearer {token}.

Responses
200
Chargeback status retrieved successfully.
application/json
400
Bad request (invalid data).
application/json
403
Access forbidden (invalid token or insufficient permissions).
application/json
404
Transaction or chargeback not found.
application/json
500
Internal server error.
application/json
get
GET /api/public/v1/credit/transactions/{transaction_id}/chargeback/{chargeback_id} HTTP/1.1
Host: transactions.transactional.uat.unico.app
Authorization: text
Accept: */*
{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

To see all possible statuses, refer to the Enumerated section.

To optimize your application's performance, you can also implement our Webhook to know when to query the Chargeback status.


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.