cURL
curl --request GET \
--url https://api.cakto.com.br/public_api/disputes/{id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cakto.com.br/public_api/disputes/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cakto.com.br/public_api/disputes/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cakto.com.br/public_api/disputes/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.cakto.com.br/public_api/disputes/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.cakto.com.br/public_api/disputes/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.cakto.com.br/public_api/disputes/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"paymentId": "0c9d4e7a-1b2f-4a6e-8d35-7f1e2a9c4b60",
"kind": "chargeback",
"status": "awaiting_defense",
"statusLabel": "Aguardando defesa",
"canSubmit": true,
"canComplement": false,
"openedAt": "2026-10-19T10:12:40.118302-03:00",
"deadline": "2026-10-25T23:59:59-03:00",
"reason": null,
"amount": "197.00",
"currency": "BRL",
"submittedAt": null,
"sentAt": null,
"decidedAt": null,
"rules": {
"maxFiles": 10,
"maxFileSizeBytes": 1900000,
"acceptedTypes": [
"application/pdf"
],
"letterMaxLength": 5000,
"letterMinLength": 300,
"messageMaxLength": 2000
},
"guideUrl": "https://ajuda.cakto.com.br/pt-br/articles/73-chargeback-pre-chargeback-e-med",
"defense": null,
"refId": "Q7W2k9P",
"orderId": "5f2a1c3e-8b7d-4e21-9f10-3c6d7a2b9e41",
"order": {
"productName": "Curso de Exemplo",
"amount": "197.00",
"formattedAmount": "R$ 197,00",
"paymentMethod": "credit_card",
"paymentMethodLabel": "Cartão de Crédito",
"installments": 1,
"createdAt": "2026-10-02T14:03:11.204871-03:00",
"paidAt": "2026-10-02T14:03:15.664021-03:00",
"customerName": "Maria Souza",
"customerEmail": "maria.souza@example.com"
}
}
Chargeback e MED
Consultar Chargeback ou MED
Tipo, prazo, regras de envio e o andamento da defesa de um pedido.
GET
/
public_api
/
disputes
/
{id}
/
cURL
curl --request GET \
--url https://api.cakto.com.br/public_api/disputes/{id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cakto.com.br/public_api/disputes/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cakto.com.br/public_api/disputes/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cakto.com.br/public_api/disputes/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.cakto.com.br/public_api/disputes/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.cakto.com.br/public_api/disputes/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.cakto.com.br/public_api/disputes/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"paymentId": "0c9d4e7a-1b2f-4a6e-8d35-7f1e2a9c4b60",
"kind": "chargeback",
"status": "awaiting_defense",
"statusLabel": "Aguardando defesa",
"canSubmit": true,
"canComplement": false,
"openedAt": "2026-10-19T10:12:40.118302-03:00",
"deadline": "2026-10-25T23:59:59-03:00",
"reason": null,
"amount": "197.00",
"currency": "BRL",
"submittedAt": null,
"sentAt": null,
"decidedAt": null,
"rules": {
"maxFiles": 10,
"maxFileSizeBytes": 1900000,
"acceptedTypes": [
"application/pdf"
],
"letterMaxLength": 5000,
"letterMinLength": 300,
"messageMaxLength": 2000
},
"guideUrl": "https://ajuda.cakto.com.br/pt-br/articles/73-chargeback-pre-chargeback-e-med",
"defense": null,
"refId": "Q7W2k9P",
"orderId": "5f2a1c3e-8b7d-4e21-9f10-3c6d7a2b9e41",
"order": {
"productName": "Curso de Exemplo",
"amount": "197.00",
"formattedAmount": "R$ 197,00",
"paymentMethod": "credit_card",
"paymentMethodLabel": "Cartão de Crédito",
"installments": 1,
"createdAt": "2026-10-02T14:03:11.204871-03:00",
"paidAt": "2026-10-02T14:03:15.664021-03:00",
"customerName": "Maria Souza",
"customerEmail": "maria.souza@example.com"
}
}
Escopo
read orders
O que esta chamada traz
A disputa do pedido{id}:
kind:chargeback(cartão) oumed(Pix);deadline: o fim do prazo do produtor, às 23:59 de Brasília. São 6 dias corridos no chargeback e 2 no MED, contados do registro da contestação na sua conta;canSubmit: se a defesa ainda pode ser enviada.canComplement: se o Compliance pediu um complemento e o prazo ainda corre;rules: os limites do envio (quantidade e tamanho dos PDFs, tamanho da carta e da mensagem);defense:nullaté o envio. Depois, a carta, os documentos, o pedido de complemento (infoRequest) e o andamento emtimeline.
Estados (status)
| Valor | O que significa |
|---|---|
awaiting_defense | A contestação foi registrada e o prazo está correndo |
expired | O prazo terminou sem envio. A defesa não é mais aceita |
submitted, in_review | O Compliance da Cakto está conferindo a documentação |
needs_info | O Compliance pediu um complemento. A mensagem está em defense.infoRequest |
sent | A defesa foi encaminhada à adquirente ou à instituição do Pix |
won | Revertido a seu favor |
lost | Mantido pelo banco |
declined | A Cakto não encaminhou a defesa. O motivo está em defense.declineReason |
Erros
| Código | Quando |
|---|---|
404 | Pedido sem chargeback ou MED, inexistente ou de outra conta |
502 | O serviço de pagamentos não respondeu. Repita a chamada |
Authorizations
Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.
Path Parameters
Id do pedido com chargeback ou MED.
Response
status é o do painel: awaiting_defense, expired, submitted, in_review, needs_info (complemento pedido, com a mensagem em defense.infoRequest), sent, won, lost ou declined. defense vem null até o envio.
Was this page helpful?