O que mudou

Confirmamos que a Celcoin não oferece devolução (estorno) de PIX — a API dela expõe estorno apenas para cartão e boleto, e o painel não mostra ação de estorno para um PIX pago. Ou seja: um estorno de PIX processado pela Celcoin nunca vai completar por aqui.

Antes, POST /api/v1/charges/{uuid}/refund tentava o estorno e, na recusa, respondia 409 pix_not_settled com "tente novamente após a liquidação" — o que sugeria, erradamente, que era uma questão de tempo. Não é. Agora a cobrança é recusada na hora, sem chamar o provedor, com uma resposta honesta e terminal:

• HTTP 422 (a cobrança é válida, mas seu tipo não permite estorno).
• Campo code: "pix_refund_unsupported" — estável, para tratar em código.
• Mensagem: "Estorno de Pix não é suportado para cobranças processadas pela Celcoin. Faça a devolução manualmente ao cliente (por exemplo, um Pix de volta)."

{
  "statusCode": 422,
  "code": "pix_refund_unsupported",
  "message": "Estorno de Pix não é suportado para cobranças processadas pela Celcoin. Faça a devolução manualmente ao cliente (por exemplo, um Pix de volta).",
  "path": "/api/v1/charges/{uuid}/refund"
}

Vale para o estorno pela API e pelo painel — os dois passam pelo mesmo caminho.

O que continua funcionando

• Estorno de cartão e boleto (Celcoin) — inalterado.
• Estorno de PIX Automático (Woovi) — é um caminho diferente (devolução via Woovi) e segue suportado.

Precisa fazer algo?

Se você automatizou tratando o 409 pix_not_settled como "tentar de novo", troque para reconhecer o 422 pix_refund_unsupported como recusa definitiva: para devolver um PIX Celcoin, faça a transferência de volta manualmente ao cliente.