Pix

Devoluções Pix

Devolver um Pix recebido na conta titular.

Objetivo

Devolver, no todo ou em parte, um Pix recebido nesta conta.

Pré-requisito: Login da conta. Scopes baas.pix-refunds.read e baas.pix-refunds.write.

Regras

  • Só é possível devolver Pix cujo recebimento está no extrato desta conta (até 90 dias).
  • value é o valor em centavos, maior que zero.
  • A soma das devoluções já concluídas com sucesso mais este value não pode passar do valor original.
  • Havendo devolução ainda em processamento para o mesmo end_to_end_id, a nova solicitação é recusada.
  • Devolução que não se realizou não consome o valor.

Endpoints

Listar

MétodoGET
Path/api/v2/baas/devolutions
Scopebaas.pix-refunds.read

Filtros opcionais: limit, offset, end_to_end_id, status.

Consultar

MétodoGET
Path/api/v2/baas/devolutions/{id}
Scopebaas.pix-refunds.read

id numérico da devolução desta conta.

Solicitar

MétodoPOST
Path/api/v2/baas/devolutions
Scopebaas.pix-refunds.write

Autenticação

Bearer da conta e HMAC.

Corpo

CampoRegra
end_to_end_idObrigatório. End-to-end do Pix original recebido
tx_idObrigatório. Txid do Pix original
valueCentavos, maior que zero
descriptionOpcional, até 140 caracteres

A resposta traz a movimentação de saída em exit (end_to_end_id, value, status).

Contrato: Listar, Consultar, Solicitar.

2025 © Nuvende - CNPJ 38.297.374/0001-93