> ## 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.

# Close an Infraction Report

> Use this endpoint to submit the closure analysis for an infraction
report received. This endpoint must be used to respond to infractions
reported to your PSP, meaning when the account was the receiver of the
transaction reported as fraud, within 7 days with the analysis result.


**Notes:**

- Closing a report sets its status to CLOSED and records the analysis
result.

- Once closed, the report cannot be modified.

- For `REFUND_REQUEST` infractions, the report must be closed by the
payee's PSP.

- For `REFUND_CANCELLED` infractions, the report must be closed by the
payer's PSP.



## OpenAPI

````yaml /en/openapi/v3-current/indirect-pix.yaml post /v1/dict/infraction-reports/{infraction_id}/close
openapi: 3.0.3
info:
  title: Plugin BR Pix Indirect - Complete API
  description: |
    Complete API for Brazilian Pix instant payment system including
    Pix key dictionary operations, QR code generation/decoding, transactions and
    transaction limits.
  version: 1.0.0
servers:
  - url: https://plugin-pix-indirect.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/dict/infraction-reports/{infraction_id}/close:
    post:
      tags:
        - MED API
      summary: Close an Infraction Report
      description: |-
        Use this endpoint to submit the closure analysis for an infraction
        report received. This endpoint must be used to respond to infractions
        reported to your PSP, meaning when the account was the receiver of the
        transaction reported as fraud, within 7 days with the analysis result.


        **Notes:**

        - Closing a report sets its status to CLOSED and records the analysis
        result.

        - Once closed, the report cannot be modified.

        - For `REFUND_REQUEST` infractions, the report must be closed by the
        payee's PSP.

        - For `REFUND_CANCELLED` infractions, the report must be closed by the
        payer's PSP.
      parameters:
        - $ref: '#/components/parameters/InfractionId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CloseInfractionReportInput'
            example:
              analysisResult: AGREED
              analysisDetails: Analysis confirms fraudulent activity pattern
      responses:
        '200':
          description: Infraction report closed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InfractionReportObject'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX0001:
                  $ref: '#/components/examples/ErrorPIX0001'
                ErrorPIX0003:
                  $ref: '#/components/examples/ErrorPIX0003'
                ErrorPIX0004:
                  $ref: '#/components/examples/ErrorPIX0004'
                ErrorPIX0208:
                  $ref: '#/components/examples/ErrorPIX0208'
                ErrorPIX0209:
                  $ref: '#/components/examples/ErrorPIX0209'
                ErrorPIX0210:
                  $ref: '#/components/examples/ErrorPIX0210'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX0216:
                  $ref: '#/components/examples/ErrorPIX0216'
                ErrorPIX0217:
                  $ref: '#/components/examples/ErrorPIX0217'
        '404':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX0200:
                  $ref: '#/components/examples/ErrorPIX0200'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX0207:
                  $ref: '#/components/examples/ErrorPIX0207'
                ErrorPIX0223:
                  $ref: '#/components/examples/ErrorPIX0223'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX0000:
                  $ref: '#/components/examples/ErrorPIX0000'
        '502':
          description: Bad Gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                ErrorPIX1000:
                  $ref: '#/components/examples/ErrorPIX1000'
                ErrorPIX1007:
                  $ref: '#/components/examples/ErrorPIX1007'
                ErrorPIX1099:
                  $ref: '#/components/examples/ErrorPIX1099'
      deprecated: false
      security:
        - bearerAuth: []
components:
  parameters:
    InfractionId:
      name: infraction_id
      in: path
      description: Unique identifier of the infraction report (UUID format).
      required: true
      example: 019c96a0-0c98-799e-9135-4613ca469ad8
      schema:
        type: string
  schemas:
    CloseInfractionReportInput:
      type: object
      required:
        - analysisResult
      properties:
        analysisResult:
          type: string
          description: Analysis result.
          enum:
            - AGREED
            - DISAGREED
          example: AGREED
        analysisDetails:
          type: string
          description: Detailed analysis comments.
          example: Analysis confirms fraudulent activity pattern
    InfractionReportObject:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier.
          example: 019c96a0-0c98-799e-9135-4613ca469ad8
        transactionId:
          type: string
          description: SPI transaction identifier.
          example: E12345678202411241430ABCDEFGHIJK
        status:
          type: string
          description: Current status.
          enum:
            - OPEN
            - ACKNOWLEDGED
            - CLOSED
            - CANCELLED
          example: OPEN
        reason:
          type: string
          description: Infraction reason.
          example: REFUND_REQUEST
        reporterParticipant:
          type: string
          description: ISPB of the reporting participant.
          example: '12345678'
        counterpartyParticipant:
          type: string
          description: ISPB of the counterparty.
          example: '87654321'
        analysisResult:
          type: string
          description: BACEN analysis result.
          example: AGREED
        createdAt:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
        updatedAt:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
    ErrorFormat:
      type: object
      description: The response message error.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: A unique, stable identifier for the error.
        title:
          type: string
          description: A brief summary of the issue.
        message:
          type: string
          description: Detailed guidance for resolving the error.
  examples:
    ErrorPIX0001:
      summary: Missing Headers in Request
      value:
        code: PIX-0001
        title: Missing Headers in Request
        message: >-
          Your request is missing one or more required header params. Please
          refer to the documentation to ensure all necessary header params are
          included in your request.
    ErrorPIX0003:
      summary: Missing Fields in Request
      value:
        code: PIX-0003
        title: Missing Fields in Request
        message: >-
          Your request is missing one or more required fields. Please refer to
          the documentation to ensure all necessary fields are included in your
          request.
    ErrorPIX0004:
      summary: Invalid Field Values in Request
      value:
        code: PIX-0004
        title: Invalid Field Values in Request
        message: >-
          Your request contains one or more fields with invalid values. Please
          refer to the documentation to verify that all fields have the correct
          values.
    ErrorPIX0208:
      summary: Infraction Fraud Type Required
      value:
        code: PIX-0208
        title: Infraction Fraud Type Required
        message: The fraud type is required when analysis result is AGREED.
    ErrorPIX0209:
      summary: Infraction Analysis Details Required
      value:
        code: PIX-0209
        title: Infraction Analysis Details Required
        message: The analysis details are required when fraud type is OTHER.
    ErrorPIX0210:
      summary: Infraction Analysis Details Too Long
      value:
        code: PIX-0210
        title: Infraction Analysis Details Too Long
        message: >-
          The analysis details exceed the maximum allowed length of 2000
          characters.
    ErrorPIX0216:
      summary: Unauthorized to Close Refund Request
      value:
        code: PIX-0216
        title: Unauthorized to Close Refund Request
        message: A refund request infraction report must be closed by the payee's PSP.
    ErrorPIX0217:
      summary: Unauthorized to Close Cancellation Report
      value:
        code: PIX-0217
        title: Unauthorized to Close Cancellation Report
        message: >-
          A cancellation of refund infraction report must be closed by the
          payer's PSP.
    ErrorPIX0200:
      summary: Infraction Report Not Found
      value:
        code: PIX-0200
        title: Infraction Report Not Found
        message: The infraction report was not found.
    ErrorPIX0207:
      summary: Infraction Report Cannot Be Closed
      value:
        code: PIX-0207
        title: Infraction Report Cannot Be Closed
        message: The infraction report cannot be closed in current status.
    ErrorPIX0223:
      summary: Infraction Report Cannot Be Acknowledged
      value:
        code: PIX-0223
        title: Infraction Report Cannot Be Acknowledged
        message: The infraction report cannot be acknowledged in current status.
    ErrorPIX0000:
      summary: Internal Server Error
      value:
        code: PIX-0000
        title: Internal Server Error
        message: The server encountered an unexpected error. Please try again later.
    ErrorPIX1000:
      summary: Provider Connection Error
      value:
        code: PIX-1000
        title: Provider Connection Error
        message: Failed to connect to provider.
    ErrorPIX1007:
      summary: Provider Internal Error
      value:
        code: PIX-1007
        title: Provider Internal Error
        message: Provider returned an internal error.
    ErrorPIX1099:
      summary: Provider Unmapped Error
      value:
        code: PIX-1099
        title: Provider Unmapped Error
        message: Provider returned an unmapped error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````