> ## 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. # Registrar crédito de devolução MED de entrada > Registra o CRÉDITO de devolução do lado recebedor no ledger local do Midaz quando o SPI liquida uma devolução MED. Registra um lançamento de partidas dobradas COMMITTED e balanceado (crédito na compensação, débito-espelho no recebedor) e cunha o idCreditoSgct. O cabeçalho Authorization (Bearer) é obrigatório nesta entrada financeira: um token ausente/inválido é um 401 codificado. Um crédito reentregue para o mesmo endToEndIdDevolucao ecoa o idCreditoSgct anterior sem um segundo lançamento (idempotente). ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml POST /sgct/jdpi/spi/api/v2/credito/devolucao 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: /sgct/jdpi/spi/api/v2/credito/devolucao: post: tags: - MED API summary: Registrar crédito de devolução MED de entrada description: >- Registra o CRÉDITO de devolução do lado recebedor no ledger local do Midaz quando o SPI liquida uma devolução MED. Registra um lançamento de partidas dobradas COMMITTED e balanceado (crédito na compensação, débito-espelho no recebedor) e cunha o idCreditoSgct. O cabeçalho Authorization (Bearer) é obrigatório nesta entrada financeira: um token ausente/inválido é um 401 codificado. Um crédito reentregue para o mesmo endToEndIdDevolucao ecoa o idCreditoSgct anterior sem um segundo lançamento (idempotente). parameters: - description: >- Token de acesso Bearer (o portão de entrada financeira; o handler falha de forma fechada com Pix-0082 quando ausente). in: header name: Authorization schema: description: >- Token de acesso Bearer (o portão de entrada financeira; o handler falha de forma fechada com Pix-0082 quando ausente). type: string - description: >- Chave de idempotência (= o endToEndIdDevolucao). Obrigatório conforme o contrato de crédito SPI do MED. in: header name: Chave-Idempotencia required: true schema: description: >- Chave de idempotência (= o endToEndIdDevolucao). Obrigatório conforme o contrato de crédito SPI do MED. type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/InboundCreditBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/InboundCreditView' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro components: schemas: InboundCreditBody: additionalProperties: false properties: codigoDevolucao: description: Código de motivo do estorno (BE08/FR01/MD06/SL02). type: string dtContabil: description: Data contábil do SPI. type: string dtHrLiquidacao: description: Instante de liquidação do SPI. type: string dtHrOp: description: Instante original informado pelo recebedor (UTC). type: string endToEndIdDevolucao: description: >- EndToEndId da devolução (pacs.004; a chave natural / âncora de idempotência, 32 caracteres). type: string endToEndIdOriginal: description: EndToEndId do pagamento contestado original (32 caracteres). type: string idReqJdPi: description: O id da requisição upstream da notificação de crédito. type: string motivoDevolucao: description: Detalhe de devolução em texto livre. type: string pagador: $ref: '#/components/schemas/InboundCreditPagador' recebedor: $ref: '#/components/schemas/InboundCreditRecebedor' valor: description: Valor de devolução creditado, em reais. format: double type: number required: - idReqJdPi - endToEndIdDevolucao - valor - pagador - recebedor type: object InboundCreditView: additionalProperties: false properties: dtHrCreditoSgct: description: >- O instante de confirmação de crédito do gateway de liquidação (UTC, RFC 3339). type: string idCreditoSgct: description: O id da entrada de crédito cunhado pelo serviço (GUID). type: string idReqJdPi: description: O id da requisição upstream (ecoado). type: string required: - idReqJdPi - idCreditoSgct - dtHrCreditoSgct 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 InboundCreditPagador: additionalProperties: false properties: cpfCnpj: description: CPF ou CNPJ do pagador (uma string v5.5.0). type: string ispb: description: ISPB do participante pagador (8 dígitos, uma string v5.5.0). type: string nome: description: Nome/razão social do pagador. type: string nrAgencia: description: Agência do pagador (4 dígitos, uma string). type: string nrConta: description: Número da conta do pagador (uma string). type: string required: - ispb type: object InboundCreditRecebedor: additionalProperties: false properties: cpfCnpj: description: CPF ou CNPJ do recebedor (uma string v5.5.0). type: string ispb: description: ISPB do participante recebedor (8 dígitos, uma string v5.5.0). type: string nrAgencia: description: Agência do recebedor (4 dígitos, uma string). type: string nrConta: description: Número da conta do recebedor (uma string). type: string tpConta: description: Tipo de conta do recebedor. format: int64 type: integer required: - ispb 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). ````