Você pode estornar parcialmente uma assinatura pela API do Asaas. O estorno é feito na cobrança gerada pela assinatura, e não na assinatura em si. Antes de começar, confirme que a cobrança foi paga por cartão de crédito ou Pix.
Para fazer o estorno parcial, siga as instruções abaixo:
- Consulte as cobranças da assinatura pelo endpoint: Listar cobranças de uma assinatura e anote o ID da cobrança que vai estornar;
- A cobrança de cartão de crédito precisa estar com o status CONFIRMED ou RECEIVED. A cobrança de Pix precisa estar com o status RECEIVED e ter sido recebida há, no máximo, 90 dias;
- Com o ID da cobrança, use o endpoint: Estornar cobrança e informe no campo value o valor a devolver. Se o value não for informado, o estorno será integral;
- No Pix, a mesma cobrança aceita mais de um estorno parcial, desde que a soma dos estornos não passe do valor total da cobrança;
- Você precisa ter saldo disponível na conta Asaas no valor do estorno.
Exemplo: se a assinatura gerou uma cobrança de R$ 100,00 e você precisa devolver R$ 30,00, estorne essa cobrança informando 30.00 no campo value.
Filtrar as cobranças recebidas de uma assinatura:
GET https://api.asaas.com/v3/subscriptions/{id}/payments?status=RECEIVED
O estorno não cancela a assinatura, e as próximas cobranças continuam sendo geradas. Para interromper a recorrência, a assinatura precisa ser removida separadamente.
Para acompanhar o estorno, use os Webhooks ou consulte os estornos da cobrança. O estorno só está concluído quando o status for DONE. Mais detalhes em Estornos.
Para mais informações sobre estornos, acesse os artigos: