Documentação

Estorno total ou parcial de um pedido

POST https://api.fbits.net/pedidos/estorno/{pedidoId}

Suggest Edits

Para efetuar um estorno total ou parcial de um pedido "pago" no Gateway de Pagamento, utilize o endpoint https://api.fbits.net/pedidos/estorno/{pedidoId}.

O endpoint permite realizar um estorno total onde o valor estornado é 100% do valor do pedido. Também permite realizar o estorno parcial onde o valor estornado é menor que o total do valor do pedido.

Exemplo:
Pedido: 101014
Total do pedido: R$ 100,00
Valor do estorno deve ser igual ou menor que 100.00.

Obs: Atualmente o estorno está disponível para Gateway Wake, Adyen,Pagar.me 2.0, Pagamento Customizado, Maxipago By Rede, Cielo, Braintree, Pagbank, KOIN, Pagaleve e Paypal BCDC.

Além disso, ao ativar a configuração geral “Devolver saldo de conta corrente em estornos de pedidos”, o sistema também realiza o estorno automático do valor de conta corrente utilizado no pedido.
Nesse caso, o estorno do saldo de conta corrente ocorre antes da devolução via Gateway.

Exemplo prático:
Em um pedido de R$ 300,00, sendo R$ 100,00 de saldo de conta corrente e R$ 200 pagos no cartão:

  1. O valor de R$ 100 é devolvido primeiro para o saldo de conta corrente.
  2. Em seguida, o sistema realiza o estorno de R$ 200 no cartão do cliente.

🔄 Importante: Após ativar a configuração, aguarde aproximadamente 10 minutos para atualização de cache antes de realizar os testes de estorno.

Parâmetros para solicitação:

  • pedidoId - Id do pedido;

Request body:

{
  "contaCorrente": {
    "referencia": "string"
  },
  "valor": 100
}

O ID de referência é opcional e pode ser preenchido quando houver saldo de conta corrente envolvido para fazer a conciliação financeira.

API Reference:

Updated 19 days ago