CreateChargebackRequest

Request body to create a new PIX MED Chargeback (Devolução)

  • amount
    Type: number
    required

    Requested refund amount in BRL; must be positive and ≤ original transaction amount

  • reason
    Type: string enum
    required

    Reason for the PIX MED Refund, mapping to Bacen RefundReason

    values
    • FRAUD
    • OPERATIONAL_FLAW
    • PIX_AUTOMATICO
  • transactionId
    Type: string
    min length:  
    1    Pattern: [A-Za-z0-9]{32}
    required

    End-to-end ID of the original PIX transaction to be refunded (exactly 32 alphanumeric chars)

  • details
    Type: string
    max length:  
    2000

    Additional context about the refund request; required when reason is OPERATIONAL_FLAW (enforced in use case)

  • infractionReportId
    Type: string Format: uuid

    Reference to the InfractionReport that originated this chargeback; required when reason is FRAUD (enforced in use case)