Devolução (Refund) de uma transação PIX aprovada

POST

/api/movimentacao/{accountId}/instant-payments/{transactionId}/returns

Devolução total ou parcial. returnReasonCode deve ser um código do Banco Central — consulte via operationId consultarMotivosDevolucao.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Sucesso

application/json

Devolução registrada

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠422UnprocessableEntity

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/movimentacao//instant-payments//returns' \
--header 'Content-Type: application/json' \
--data '{
    "externalIdentifier": "d81540e9-e579-4352-9b98-00552cb39164",
    "amount": 50,
    "returnReasonCode": "MD06"
}'

Response Example

200 - Sucesso

{
    "data": {
        "transactionId": "6FA62ACC-E448-D51D-C3AA-9D4EA2BDCEA0"
    }
}

Modificado em 2026-07-15 14:29:20

Página anterior

Reemissão de cobranças em PDF

Próxima página

Criar cobrança PIX (Integração) com valores por parcela