Accounts / Pix

Solicitar devolucao Pix

Solicita devolucao total ou parcial de uma transacao Pix recebida.

POST/hb/pix/refunds

Requisicao

AutenticacaomTLS + Bearer Token

AmbienteDefinido pelo certificado

ContaEnviar x-account-id

IdempotenciaNao aplicavel

Campos obrigatorios

transaction_id

Valores aceitos

refund_reason0 - Indefinido | 1 - Fraude | 2 - Cobranca indevida | 3 - Cancelamento | 4 - Falha operacional

Body exemplo

{
  "transaction_id": "E00000000202605071030abcdef123456",
  "amount": 10,
  "refund_reason": 2,
  "additional_informations": "Cobranca indevida"
}

Exemplos de execucao

curl -X POST 'https://uzepay-mtls.deploy.pixland.com.br/hb/pix/refunds' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -H 'x-account-id: <ACCOUNT_ID>' \
  -d '{
  "transaction_id": "E00000000202605071030abcdef123456",
  "amount": 10,
  "refund_reason": 2,
  "additional_informations": "Cobranca indevida"
}'

Resposta exemplo

200 OK

{
  "refund": {
    "id": "01JW...",
    "status": "PROCESSING",
    "amount": 10
  }
}