> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Abrir solicitação de devolução MED > Abre uma solicitação de devolução como PSP solicitante. O ISPB solicitante é derivado da configuração. Persiste a entidade de resposta do upstream e a retorna. ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml POST /v1/med/refunds openapi: 3.0.3 info: title: Plugin BR Pix Direct - API Completa description: > API completa para o sistema de pagamentos instantaneos PIX brasileiro, incluindo operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes, transacoes e limites de transacao. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/med/refunds: post: tags: - MED API summary: Abrir solicitação de devolução MED description: >- Abre uma solicitação de devolução como PSP solicitante. O ISPB solicitante é derivado da configuração. Persiste a entidade de resposta do upstream e a retorna. requestBody: content: application/json: schema: $ref: '#/components/schemas/SolicitRefundRequestBody' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/RefundRequestView' description: Aceito default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro components: schemas: SolicitRefundRequestBody: additionalProperties: false properties: detalhes: description: >- Detalhe em texto livre; obrigatório quando motivo=0 (Falha Operacional). type: string endToEndId: description: >- EndToEndId do pagamento contestado (ou id do pacs.004 para um motivo de cancelamento). type: string idempotencyKey: description: Chave de idempotência derivada do negócio (Chave-Idempotencia). type: string motivo: description: >- Motivo da devolução (0=Falha Operacional, 1=Fraude, 3=Pix Automático). format: int64 type: integer valorDevolucaoCents: description: Valor de devolução solicitado, em centavos. format: int64 type: integer required: - endToEndId - motivo - valorDevolucaoCents - idempotencyKey type: object RefundRequestView: additionalProperties: false properties: analysisDeadline: description: >- Prazo de análise do lado contestado; nulo para o lado do solicitante e para requisições terminais. type: string breached: description: >- True quando o prazo de análise foi atingido ou ultrapassado (computado no momento da leitura); false quando nenhum prazo está definido. type: boolean detalhes: description: Detalhe em texto livre. type: string detalhesAnalise: description: Detalhe da análise. type: string dtHrCriacao: description: Data/hora de criação no upstream (RFC 3339 UTC). type: string dtHrUltModificacao: description: >- Data/hora da última modificação no upstream (RFC 3339 UTC) — o watermark do poll. type: string endToEndId: description: EndToEndId do pagamento contestado ou devolução. type: string endToEndIdDevolucao: description: referência da devolução pacs.004/pacs.008, registrada na análise. type: string idRecValores: description: GUID da recuperação de valores, quando a partir de uma recuperação. type: string idRelatoInfracao: description: GUID da infração vinculada, quando fraude. type: string idSolDevolucao: description: GUID da solicitação de devolução (a chave natural). type: string ispbContestado: description: ISPB do PSP contestado. type: string ispbSolicitante: description: ISPB do PSP solicitante. type: string motivo: description: >- Código de motivo da devolução (0=Falha Operacional, 1=Fraude, 3=Pix Automático). format: int64 type: integer motivoDescription: description: Rótulo legível do motivo da devolução. type: string motivoRejeicao: description: >- Motivo de rejeição (0,1,3,4); presente somente quando a análise rejeitou a requisição. format: int64 type: integer motivoRejeicaoDescription: description: Rótulo legível do motivo de rejeição. type: string resultadoAnalise: description: >- Resultado de análise da devolução (0=Aceita Totalmente, 1=Aceita Parcialmente, 2=Rejeitada); nulo até ser analisada. format: int64 type: integer resultadoAnaliseDescription: description: Rótulo legível do resultado de análise da devolução. type: string status: description: >- código de ciclo de vida stSolDevolucao (0=Aberta, 1=Cancelada, 2=Analisada). format: int64 type: integer statusDescription: description: Rótulo legível de stSolDevolucao. type: string valorDevolucaoCents: description: Valor de devolução solicitado, em centavos. format: int64 type: integer valorDevolvidoCents: description: Valor efetivamente devolvido, em centavos; nulo quando ausente. format: int64 type: integer required: - idSolDevolucao - endToEndId - motivo - motivoDescription - valorDevolucaoCents - status - statusDescription - ispbSolicitante - ispbContestado - dtHrCriacao - dtHrUltModificacao - breached type: object Detail: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina, escopado ao serviço emissor (formato: -NNNN). type: string detail: description: Uma explicação legível específica desta ocorrência do problema. type: string errors: description: Lista opcional de detalhes individuais de erro items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Uma referência URI que identifica a ocorrência específica do problema. format: uri type: string status: description: Código de status HTTP format: int64 type: integer title: description: >- Um resumo curto e legível do tipo de problema. Este valor não deve mudar entre ocorrências do erro. type: string type: default: about:blank description: Uma referência URI para a documentação legível do erro. format: uri type: string type: object ErrorDetail: additionalProperties: false properties: location: description: Onde o erro ocorreu, ex. 'body.items[3].tags' ou 'path.thing-id' type: string message: description: Texto da mensagem de erro type: string value: description: O valor no local informado type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticacao por token JWT Bearer. Obtenha o token no endpoint `/v1/login/oauth/access_token` usando credenciais do cliente (clientId e clientSecret). Inclua o token no header Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` O token expira apos 3600 segundos (1 hora). ````