> ## Documentation Index > Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Consultar Chargeback ou MED > Tipo, prazo, regras de envio e o andamento da defesa de um pedido. #### Escopo ```bash theme={null} read orders ``` ## O que esta chamada traz A disputa do pedido `{id}`: * `kind`: `chargeback` (cartão) ou `med` (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`: `null` até o envio. Depois, a carta, os documentos, o pedido de complemento (`infoRequest`) e o andamento em `timeline`. ## 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 | ## OpenAPI ````yaml GET /public_api/disputes/{id}/ openapi: 3.0.3 info: title: Cakto API version: 1.0.0 description: Documentação da API pública do Cakto. servers: - url: https://api.cakto.com.br description: Cakto API security: [] paths: /public_api/disputes/{id}/: get: tags: - disputes description: >- A disputa de um pedido: tipo, prazo, se ainda dá para enviar ou complementar a defesa (`canSubmit`, `canComplement`), as regras de arquivo e, depois do envio, a defesa com a carta, os documentos e o andamento. operationId: disputes_retrieve parameters: - in: path name: id schema: type: string description: Id do pedido com chargeback ou MED. required: true responses: '200': content: application/json: schema: type: object additionalProperties: {} examples: AguardandoDefesa: value: 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 summary: Aguardando defesa DefesaEnviada: value: paymentId: 0c9d4e7a-1b2f-4a6e-8d35-7f1e2a9c4b60 kind: chargeback status: submitted statusLabel: Em análise pela Cakto canSubmit: false 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: '2026-10-20T09:41:22.873610-03:00' 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: status: submitted submittedAt: '2026-10-20T09:41:22.873610-03:00' letter: >- Prezado banco, a compradora Maria Souza adquiriu o Curso de Exemplo em 02/10/2026 e acessou as aulas em 03/10 e 05/10, como mostra o registro de acesso anexo... documents: - id: 912 name: registro-de-acesso.pdf sizeBytes: 184213 origin: seller uploadedAt: '2026-10-20T09:41:22.873610-03:00' infoRequest: null declineReason: null sentAt: null decidedAt: null timeline: - at: '2026-10-19T10:12:40.118302-03:00' label: Chargeback registrado na sua conta detail: null state: done - at: '2026-10-20T09:41:22.873610-03:00' label: Defesa enviada por você detail: 1 arquivo state: done - at: null label: Conferência da Cakto detail: null state: current 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 summary: Defesa enviada description: >- `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. '401': description: Request não autenticado devido à ausência ou invalidez do token. content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedError' examples: Token ausente ou inválido: $ref: '#/components/examples/UnauthenticatedErrorExample' '404': content: application/json: schema: type: object additionalProperties: {} examples: NaoEncontrado: value: detail: Não encontrado. description: >- Pedido sem chargeback ou MED, ou de outra conta: 403 confirmaria que o id existe. '502': content: application/json: schema: type: object additionalProperties: {} examples: ServicoIndisponivel: value: detail: >- Não foi possível falar com o serviço de pagamentos. Tente de novo em instantes. description: >- O serviço de pagamentos não respondeu. Nada foi gravado: repita a chamada. security: - OAuth Token: [] components: schemas: UnauthenticatedError: type: object properties: detail: type: string examples: UnauthenticatedErrorExample: summary: Token ausente ou inválido description: Token ausente ou inválido value: detail: As credenciais de autenticação não foram fornecidas. securitySchemes: OAuth Token: type: http scheme: bearer in: header name: Authorization description: >- Token de autenticação do tipo `Bearer {access_token}`, onde `{access_token}` é o token obtido no fluxo de [autenticação](/authentication). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.