Skip to main content
PUT
/
baas
/
api
/
v1
/
transactions
/
pix
/
{endToEndIdOriginal}
/
refund
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,
    "externalId": "devolucao-pedido-9817",
    "description": "Devolução solicitada pelo cliente"
}'

{
    "idempotencyKey": "421ece97-a8d2-4c45-afaf-3c8f81666fd2",
    "externalId": "devolucao-pedido-9817",
    "endToEndId": "D38224857202502281706FA489GE2ZSN",
    "status": "PIX_PROCESSING",
    "createdAt": "2025-02-28T17:06:41.963Z"
}
Para o passo a passo completo, veja o guia Devolver um Pix Recebido.

​
Headers

​
x-delbank-api-key
string
required
Sua API key.
​
x-delfinance-account-id
string
required
Número da conta Delfinance.
​
IdempotencyKey
string
required
UUID v4 único por requisição, garante idempotência da operação.

​
Path

​
endToEndIdOriginal
string
required
O endToEndId da transação Pix original que foi recebida e será devolvida. Disponível no payload do webhook PIX_RECEIVED ou no extrato da conta.

​
Body

​
amount
number
required
Valor a devolver em reais. Para devolução total, informe o valor exato do Pix recebido. Para devolução parcial, informe um valor menor. O somatório de todas as devoluções não pode ultrapassar o valor original.
​
externalId
string
Identificador externo para conciliação no seu sistema. Máximo de 40 caracteres.
​
description
string
Descrição interna da devolução.

​
Response

​
idempotencyKey
string
Chave de idempotência enviada na requisição.
​
externalId
string
Identificador externo informado, se enviado.
​
endToEndId
string
Identificador único da devolução (prefixo D). Diferente do endToEndId original da transação recebida (prefixo E).
​
status
string
Status inicial da devolução: PIX_PROCESSING.
​
createdAt
string
Timestamp de criação da solicitação em ISO 8601.
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,
    "externalId": "devolucao-pedido-9817",
    "description": "Devolução solicitada pelo cliente"
}'

{
    "idempotencyKey": "421ece97-a8d2-4c45-afaf-3c8f81666fd2",
    "externalId": "devolucao-pedido-9817",
    "endToEndId": "D38224857202502281706FA489GE2ZSN",
    "status": "PIX_PROCESSING",
    "createdAt": "2025-02-28T17:06:41.963Z"
}