ChargebackResponse

PIX MED Chargeback (Devolução) details returned by the API

  • amount
    Type: number

    Requested refund amount in BRL

  • analysisDetails
    Type: string

    Analysis notes from the credited participant

  • analysisResult
    Type: string enum

    Result of the crediting participant's analysis on a Refund request (Bacen DICT API v2.10.1)

    values
    • TOTALLY_ACCEPTED
    • PARTIALLY_ACCEPTED
    • REJECTED
  • contestedParticipant
    Type: string

    ISPB of the participant who must process the refund (credited side)

  • creationTime
    Type: string Format: date-time

    ISO-8601 timestamp of creation (UTC)

  • details
    Type: string

    Additional context provided by the requesting participant

  • effectiveRefundedAmount
    Type: number

    Actual amount returned; matches amount for TOTALLY_ACCEPTED, partial for PARTIALLY_ACCEPTED, zero for REJECTED

  • flow
    Type: string enum

    Perspective of the MED object relative to our participant: OUTBOUND = we created it, INBOUND = we received it, INTERNAL = intra-PSP dispute (no DICT round-trip, med#133)

    values
    • OUTBOUND
    • INBOUND
    • INTERNAL
  • fundsRecoveryId
    Type: string Format: uuid

    UUID of the FundsRecovery that auto-created this chargeback; null for standalone MED 1.0 chargebacks

  • id
    Type: string Format: uuid

    Unique identifier of the chargeback (UUID v7)

  • infractionReportId
    Type: string Format: uuid

    Infraction report that originated this chargeback; present only when reason is FRAUD

  • lastModified
    Type: string Format: date-time

    ISO-8601 timestamp of the last state change (UTC)

  • reason
    Type: string enum

    Reason for the PIX MED Refund, mapping to Bacen RefundReason

    values
    • FRAUD
    • OPERATIONAL_FLAW
    • PIX_AUTOMATICO
  • refundTransactionId
    Type: string

    End-to-end ID of the actual refund PIX transaction; present when funds were transferred

  • rejectionReason
    Type: string enum

    Reason for rejection when a Refund is not totally accepted (Bacen DICT API v2.10.1)

    values
    • NO_BALANCE
    • ACCOUNT_CLOSURE
    • INVALID_REQUEST
    • OTHER
  • requestingParticipant
    Type: string

    ISPB of the participant who requested the refund (debited side)

  • status
    Type: string enum

    Lifecycle status of a PIX MED Refund (Devolução) per Bacen DICT API v2.10.1

    values
    • OPEN
    • CLOSED
    • CANCELLED
  • transactionId
    Type: string

    End-to-end ID of the original PIX transaction being refunded