Endpoint

POST /v2/finance/chargeback

Headers

Body Details

{
  "transaction_id": 987654,
  "information": "Order cancelled by the customer",
  "amount": 100.50
}

Request Examples

Full refund:

POST /v2/finance/chargeback
Authorization: Bearer <access_token>
hmac: <computed_hmac>
Content-Type: application/json

{
  "transaction_id": 987654,
  "information": "Order cancelled by the customer",
  "amount": 100.50
}

Partial refund:

POST /v2/finance/chargeback
Authorization: Bearer <access_token>
hmac: <computed_hmac>
Content-Type: application/json

{
  "transaction_id": 987654,
  "information": "Partial cancellation - one item returned",
  "amount": 40.00
}

Response Details

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "end_to_end_id": "E12345678202604251234567890AB12345",
  "amount": 100.50,
  "status": "PENDING"
}

Chargeback Status

Error Responses

All errors are returned in the standard error envelope:

{
  "worked": false,
  "detail": "There is a refund in processing",
  "message": "There is a refund in processing",
  "data": null
}

Business Rules

Validations:

• amount must be greater than 0 and have at most 2 decimal places
• transaction_id must reference a PIX cash in you received; transfers you sent cannot be refunded through this endpoint
• The sum of all refunds made for the same cash in cannot exceed the original amount
• For cash ins received through a PIX QR Code, the QR Code must have been paid (it stays refundable after a previous partial refund) and the sum of all refunds cannot exceed the QR Code amount
• Only one refund can be in processing at a time for the same cash in
• The account must have enough available balance at the moment of the request

Limits:

• A cash in can only be refunded within 90 days of the date it was received

Important Notes:

• Partial refunds are supported: send an amount lower than the original value and repeat the request as many times as needed, respecting the original amount
• When the payer is at another institution the response comes back as PENDING and the refund is settled asynchronously
• When the payer is in the same institution the refund is settled right away and the response already comes back as SUCCESS
• Use the Check PIX Cash In Chargeback Status endpoint with the returned id to follow the outcome
• The end_to_end_id may come back as an empty string in this response and be filled in later, once the refund is assigned one