Skip to main content
Após receber um Pix, é possível devolver o valor total ou parte dele ao pagador original. A operação é feita pelo endToEndId da transação recebida e pode ser solicitada em até 90 dias da data de recebimento.
Devoluções parciais sucessivas exigem um intervalo mínimo de 2 minutos entre cada requisição. Solicitações enviadas antes desse intervalo não serão processadas.

​
Passo a passo

1

Obtenha o endToEndId da transação recebida

O endToEndId vem no payload do webhook PIX_RECEIVED (campo endToEndId) ou pode ser consultado no extrato de transações da conta. É o identificador único do Pix original que você deseja devolver.
2

Envie a devolução

Chame PUT /baas/api/v1/transactions/pix/:endToEndIdOriginal/refund com o valor a devolver. Para devolução total, informe o mesmo valor do Pix recebido. Para devolução parcial, informe um valor menor.
curl --request PUT \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/transactions/pix/E182361202024041911111111111111/refund' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --header 'IdempotencyKey: {{$guid}}' \
  --data '{
    "amount": 100.00,
    "description": "Devolução solicitada pelo cliente"
}'

curl --request PUT \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/transactions/pix/E182361202024041911111111111111/refund' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --header 'IdempotencyKey: {{$guid}}' \
  --data '{
    "amount": 30.00,
    "externalId": "devolucao-pedido-9817",
    "description": "Devolução parcial por item cancelado"
}'
A resposta 202 Accepted confirma que a devolução foi aceita para processamento:
{
    "idempotencyKey": "421ece97-a8d2-4c45-afaf-3c8f81666fd2",
    "externalId": "devolucao-pedido-9817",
    "endToEndId": "D38224857202502281706FA489GE2ZSN",
    "status": "PIX_PROCESSING",
    "createdAt": "2025-02-28T17:06:41.963Z"
}
O endToEndId retornado (prefixo D) é o identificador da devolução — diferente do endToEndId original (prefixo E).
3

Acompanhe a conclusão via webhook

Quando a devolução for liquidada, você receberá o evento PIX_PAYMENT_UPDATED com status: PIX_EFFECTIVE. Se houver erro no processamento, o evento PIX_REFUND_PAYMENT_UPDATED será disparado. Veja Webhooks Pix para detalhes dos payloads.

​
Regras e limitações

RegraDetalhe
Prazo máximo90 dias a partir da data de recebimento do Pix original
Valor máximoO somatório das devoluções não pode ultrapassar o valor original recebido
Intervalo entre parciaisMínimo de 2 minutos entre requisições de devolução parcial para o mesmo Pix
IdempotencyKeyObrigatório, deve ser um UUID v4 único por requisição

​
Referência da API

Criar devolução Pix

PUT /baas/api/v1/transactions/pix/:endToEndIdOriginal/refund