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 'https://api-hml.lcpay.com.br/api/movimentacao/236BD098-F481-48D6-6F7F-A357E09DEB45/instant-payments/019f6b33-af9e-bacb-cbe3-4150267572ac/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-16 13:54:34

Página anterior

Reemissão de cobranças em PDF

Próxima página

Inativar cobrança com vencimento