Bradesco / Pix

Devolver Pix

Solicita devolucao Pix com idempotencia.

PUT/ar/pix/pix/:endToEndId/refund/:id

Requisicao

AutenticacaomTLS + Bearer Token

AmbienteDefinido pelo certificado

ContaNao exige header de conta

IdempotenciaIdentificador na URL

Parametros de caminho

:endToEndIdobrigatorio

EndToEndId da transacao original

Exemplo: E00000000202605071030abcdef123456

:idobrigatorio

Identificador idempotente da devolucao

Exemplo: devol-001

Body exemplo

{
  "amount": 10,
  "reason": "Pagamento em duplicidade"
}

Exemplos de execucao

curl -X PUT 'https://uzepay-mtls.deploy.pixland.com.br/ar/pix/pix/:endToEndId/refund/:id' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "amount": 10,
  "reason": "Pagamento em duplicidade"
}'

Resposta exemplo

200 OK

{
  "refund": {
    "id": "devol-001",
    "status": "PROCESSING",
    "amount": 10
  }
}