Pagar.me Contestations API
The Contestations API from Pagar.me — 1 operation(s) for contestations.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/pagar-me:pagar-me-contestations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: pagarme-api-register-v5 Contestations API
version: '5'
servers:
- url: https://api.pagar.me/register/v5
security:
- sec0: []
tags:
- name: Contestations
paths:
/contestations:
get:
summary: Retornando Contestações
description: ''
operationId: retornando-contestacoes
parameters:
- name: contract_key
in: query
description: Chave Identificadora do contrato
required: true
schema:
type: string
- name: page
in: query
description: Paginação
schema:
type: integer
format: int32
- name: size
in: query
description: Quantidade de Itens (Contestações) a serem retornardos
schema:
type: integer
format: int32
- name: id
in: query
description: Chave Identificadora da Contestação que foi aberta
schema:
type: string
- name: original_assetHolder_document
in: query
description: Documento do originador da UR
schema:
type: string
- name: status
in: query
description: Status da Contestação (Código do motivo da contestação. A lista dos códigos está na Response code 200 Enum de System)
schema:
type: string
- name: created_at
in: query
description: Data de Abertura da Contestação
schema:
type: string
format: date
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "Response 200\n{\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": \"string\",\n\t\t\t\"status\": \"string\",\n\t\t\t\"contested_document\": \"string\",\n\t\t\t\"original_asset_holder_document\": \"string\",\n\t\t\t\"reason_code\": \"string\",\n\t\t\t\"contract_key\": \"string\",\n\t\t\t\"created_at\": \"Date time\",\n\t\t\t\"reason_description\": \"string\",\n\t\t\t\"description\": \"string\",\n\t\t\t\"skip_contract\": boolean\n\t\t}\n\t],\n\t\"paging\": {\n\t\t\"total\": int,\n\t\t\"previous\": \"string\",\n\t\t\"next\": \"string\"\n\t}\n}"
text/plain:
examples:
Status Code:
value: "Enum de ReasonCode:\n{\n // Códigos Legado\n [Description(\"Contestação com base em rejeição bancária onde a conta teve um erro ao ser invalidada\")]\n SO07 = 7,\n \n [Description(\"Contestação com base em rejeição bancária indevida por parte da ID\")]\n SO08 = 8,\n \n [Description(\"Contestação com base em revogação de optin por parte de um credor\")]\n SO09 = 9,\n \n [Description(\"Contestação com base em evidência do EC de que o contrato é indevido\")]\n SO10 = 10,\n \n [Description(\"Contestação com base em rejeição por falta de acordo entre o banco e a bandeira no SLC\")]\n SO11 = 11,\n \n // Códigos atuais\n [Description(\"Problemas para liquidação do instrumento contratual ocasionado pelos dados bancários inválidos\")]\n SO01 = 1,\n \n [Description(\"Titular ou usuário final recebedor não reconhece a operação\")]\n SO02 = 2,\n \n [Description(\"Duplicidade de lançamento de operação\")]\n SO03 = 3,\n \n [Description(\"Operação em divergência com o instrumento contratual\")]\n SO04 = 4,\n \n [Description(\"Outros\")] SO05 = 5,\n \n [Description(\"Divergência entre valor esperado pelo financiador ou pela não financeira e o valor efetivamente liquidado pela instituição credenciadora ou subcredenciadora devedora da obrigação\")]\n SO06 = 6,\n \n [Description(\"Ausência de liquidação\")]\n SO12 = 12,\n \n [Description(\"Gravame baixado ainda recebendo liquidações na conta indicada\")]\n SO13 = 13,\n \n [Description(\"Titular ou usuário final recebedor não reconhece a anuência\")]\n SO15 = 15,\n \n [Description(\"Comunicação de resilição ou liberação de excedente não atendida\")]\n SO14 = 14,\n \n [Description(\"Não recebimento da agenda solicitada\")]\n SO16 = 16,\n \n [Description(\"Divergência de valores na agenda\")]\n SO17 = 17,\n \n [Description(\"Outros\")] \n SO18 = 18,\n \n [Description(\"Comunicação de resilição ou liberação de excedente indevida\")]\n SO19 = 19\n}"
deprecated: false
x-readme:
code-samples:
- language: text
code: "{\n contract_key: string\n page: int\n\tsize: int\n}"
samples-languages:
- text
tags:
- Contestations
post:
summary: Contestando um Contrato
description: ''
operationId: contestando-um-contrato-v5
requestBody:
content:
application/json:
schema:
type: object
required:
- reason_code
properties:
author:
properties:
email:
type: string
description: seu e-mail cadastrado no pagar.me
system:
type: string
description: Sistema originador da contestação. Em integração com a API, sempre utilizamos o valor API
enum:
- ''
user_Agent:
type: string
description: Nome da Sua empresa no Pagar.me
required:
- email
- system
- user_Agent
type: object
original_asset_holder:
properties:
name:
type: string
description: Nome do seller originador do recebível.
document:
type: string
description: Documento do seller originador do recebível.
required:
- name
type: object
contested:
properties:
name:
type: string
description: Nome do Credor(Asset Holder).
document:
type: string
description: Documento do Credor(Asset Holder).
required:
- document
type: object
target:
properties:
key:
type: string
description: Chave do contrato obtida no endpoint settlement_obligations
type:
type: string
description: Tipo do contrato, sempre passamos o valor Contract.
enum:
- Contract
required:
- key
- type
type: object
reason_code:
type: string
description: Código do motivo da contestação. A lista dos códigos está na Response code 200 Enum de System
enum:
- Contestação com base em rejeição bancária onde a conta teve um erro ao ser invalidada SO07 = 7
- Contestação com base em rejeição bancária indevida por parte da ID SO08 = 8
- Contestação com base em revogação de optin por parte de um credor SO09 = 9
- Contestação com base em evidência do EC de que o contrato é indevido SO10 = 10
- Contestação com base em rejeição por falta de acordo entre o banco e a bandeira no SLC SO11 = 11
- Problemas para liquidação do instrumento contratual ocasionado pelos dados bancários inválidos SO01 = 1
- Titular ou usuário final recebedor não reconhece a operação SO02 = 2
- Duplicidade de lançamento de operação SO03 = 3
- Operação em divergência com o instrumento contratual SO04 = 4
- Outros SO05 = 5
- Divergência entre valor esperado pelo financiador ou pela não financeira e o valor efetivamente liquidado pela instituição credenciadora ou subcredenciadora devedora da obrigação SO06 = 6
- Ausência de liquidação SO12 = 12
- Gravame baixado ainda recebendo liquidações na conta indicada SO13 = 13
- Titular ou usuário final recebedor não reconhece a anuência SO15 = 15
- Comunicação de resilição ou liberação de excedente não atendida SO14 = 14
- Não recebimento da agenda solicitada SO16 = 16
- Divergência de valores na agenda SO17 = 17
- Outros SO18 = 18
- Comunicação de resilição ou liberação de excedente indevida SO19 = 19
responses:
'200':
description: '200'
content:
text/plain:
examples:
reasoncode:
value: "Enum de ReasonCode:\n{\n // Códigos Legado\n [Description(\"Contestação com base em rejeição bancária onde a conta teve um erro ao ser invalidada\")]\n SO07 = 7,\n \n [Description(\"Contestação com base em rejeição bancária indevida por parte da ID\")]\n SO08 = 8,\n \n [Description(\"Contestação com base em revogação de optin por parte de um credor\")]\n SO09 = 9,\n \n [Description(\"Contestação com base em evidência do EC de que o contrato é indevido\")]\n SO10 = 10,\n \n [Description(\"Contestação com base em rejeição por falta de acordo entre o banco e a bandeira no SLC\")]\n SO11 = 11,\n \n // Códigos atuais\n [Description(\"Problemas para liquidação do instrumento contratual ocasionado pelos dados bancários inválidos\")]\n SO01 = 1,\n \n [Description(\"Titular ou usuário final recebedor não reconhece a operação\")]\n SO02 = 2,\n \n [Description(\"Duplicidade de lançamento de operação\")]\n SO03 = 3,\n \n [Description(\"Operação em divergência com o instrumento contratual\")]\n SO04 = 4,\n \n [Description(\"Outros\")] SO05 = 5,\n \n [Description(\"Divergência entre valor esperado pelo financiador ou pela não financeira e o valor efetivamente liquidado pela instituição credenciadora ou subcredenciadora devedora da obrigação\")]\n SO06 = 6,\n \n [Description(\"Ausência de liquidação\")]\n SO12 = 12,\n \n [Description(\"Gravame baixado ainda recebendo liquidações na conta indicada\")]\n SO13 = 13,\n \n [Description(\"Titular ou usuário final recebedor não reconhece a anuência\")]\n SO15 = 15,\n \n [Description(\"Comunicação de resilição ou liberação de excedente não atendida\")]\n SO14 = 14,\n \n [Description(\"Não recebimento da agenda solicitada\")]\n SO16 = 16,\n \n [Description(\"Divergência de valores na agenda\")]\n SO17 = 17,\n \n [Description(\"Outros\")] \n SO18 = 18,\n \n [Description(\"Comunicação de resilição ou liberação de excedente indevida\")]\n SO19 = 19\n}"
'201':
description: '201'
content:
application/json:
examples:
Result:
value: "{\n message: \"No Content\"\n}"
'401':
description: '401'
content:
text/plain:
examples:
Result:
value: "{\n message: \"Não Autorizado\"\n}"
'409':
description: '409'
content:
application/json:
examples:
Result:
value: '{Duplicação de contestação ja aberta}'
deprecated: false
x-readme:
code-samples:
- language: curl
code: "{\n \"author\": {\n \"email\": \"joao@pagar.me\",\n \"system\": \"API\",\n \"user_agent\": \"joao.jorge\"\n },\n \"original_asset_holder\": {\n \"name\": \"033 - Otica \",\n \"document\": \"00000000000000\"\n },\n \"contested\": {\n \"name\": \"111 - BANCO \",\n \"document\": \"00000000000000\"\n },\n \"target\": {\n \"key\": \"8935d7g4-0bfg-3f45-8g12-2635gfb3g233\",\n \"type\": \"Contract\"\n },\n \"reason_code\": \"C06ß\"\n}"
samples-languages:
- curl
tags:
- Contestations
components:
securitySchemes:
sec0:
type: http
scheme: basic
x-readme-fauxas: true
x-provenance:
method: searched
source: https://docs.pagar.me/reference
harvested: '2026-10-14'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.pagar.me/reference/contestando-um-contrato-v5.md
- https://docs.pagar.me/reference/retornando-contestacoes.md
- https://docs.pagar.me/reference/retornando-efeitos-de-contratos-copy.md
- https://docs.pagar.me/reference/retornando-efeitos-de-contratos-v5.md
merge:
pages: 4
deduped: 3
conflicts_kept_first: 0