[Cielo2] Solicitar devolução de transação Pix

Caso a sua loja precise devolver uma transferência Pix, é possível realizar uma operação chamada de devolução. Quando uma devolução é acatada, uma notificação será enviada para a sua loja.

• É necessário que o comprador (usuário pagador) solicite para a loja (usuário recebedor) a devolução total ou parcial de um pagamento realizado, via algum meio de comunicação adequado;
• A loja (usuário recebedor) concorda e identifica o pagamento original realizado pelo Pix.

Quando posso solicitar uma devolução Pix?

É possível solicitar uma devolução Pix quando, por exemplo, houver devolução do produto, erro na cobrança e indisponibilidade do produto em estoque.

Quem solicita a devolução Pix pela API E-commerce Cielo?

A loja (vendedor que recebeu a transação Pix) é quem solicita a devolução à API E-commerce Cielo, por conta própria ou por solicitação do usuário pagador. É importante se atentar aos prazos (de acordo com regulamento do Banco Central).

Como solicitar à devolução Pix?

Via API E-commerce Cielo, App Cielo Gestão ou site Cielo.

Regras para devolução Pix

• A devolução ocorrerá somente se houver saldo na conta de pagamento do estabelecimento. Para ter saldo, é necessário escolher a Gestão de Livre Movimentação na conta Pix;
• Os valores da taxa e/ou tarifa de criação da transação Pix não serão devolvidos;
• Para transferências, vendas e demais transações com o Pix o prazo para cancelamento é em até 90 dias a partir da data que tiver sido realizada a transação original, conforme especificação do Banco Central;
• A devolução de um Pix pode ser integral (valor total da transação) ou parcial (parte do valor da transação).

⚠️

Atenção

Os estabelecimentos que optarem pela transferência automática da conta Pix (Gestão Simplificada) não terão saldo em conta de pagamento. Com isso, não será possível efetuar a devolução com sucesso, e o retorno será “Lojista com saldo insuficiente para devolução”.

Requisição

Parâmetros no path

Parâmetros na query string

Parâmetros do cabeçalho

Resposta

{
    "Status": 2,
    "ReasonCode": 8,
    "ReasonMessage": "Scheduled",
    "ProviderReturnCode": "0",
    "ProviderReturnMessage": "OPERACAO REALIZADA COM SUCESSO",
    "ReturnCode": "0",
    "ReturnMessage": "OPERACAO REALIZADA COM SUCESSO",
    "AuthorizationCode": "E01027058202412021928yOpJfcc9zLl",
    "Links": [
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/b8c1b2ea-e06a-4135-9389-8bdbdccacd20"
        },
        {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/b8c1b2ea-e06a-4135-9389-8bdbdccacd20/void"
        }
    ]
}

A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na devolução de um Pix:

Mudanças nos campos

Confira as mudanças nos campos retornados no estorno ao atualizar o provedor Cielo para Cielo2: