> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usevext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# charge.refunded

> Enviado quando um estorno é concluído — inclusive os feitos fora do seu fluxo.

<Warning>
  **Confira a assinatura antes de agir.** Ver [Verificar a assinatura](/webhooks/assinatura).
</Warning>

O evento traz a cobrança **e** o estorno, porque as duas perguntas aparecem juntas do outro lado:
quanto voltou (o estorno) e se sobrou algo (a cobrança, com `status` e `refunded_amount` já
atualizados). Uma venda devolvida pela metade chega como `partially_refunded`, não `refunded`.


## OpenAPI

````yaml api-reference/openapi.yaml webhook charge.refunded
openapi: 3.1.0
info:
  title: Vext - API de pagamentos PIX com split
  version: 1.0.0
  summary: Cobranças PIX, estornos e saldo do vendedor.
  description: |
    API pública do gateway. Todo endpoint desta versão vive sob `/v1`.

    Quatro regras valem para toda chamada. Cada uma tem uma página própria
    nos guias, com exemplos nas quatro linguagens.

    - **Dinheiro é sempre centavos inteiros.** R$ 100,00 se envia como
      `10000`; um decimal devolve `422`. Ver
      [Valores em centavos](/essenciais/valores-em-centavos).
    - **A chave secreta vai no header e fica no servidor.** Cada chave
      carrega escopos; fora do escopo devolve `403`, e não `401`. Ver
      [Autenticação](/essenciais/autenticacao).
    - **Envie `Idempotency-Key` em todo `POST`.** Repetir com a mesma chave
      devolve a resposta gravada em vez de criar um segundo recurso. Ver
      [Idempotência](/essenciais/idempotencia).
    - **Trate os erros pelo `code`**, nunca pela `message` - o código é
      contrato, o texto pode ser reescrito a qualquer momento. Ver
      [Erros](/essenciais/erros).
  contact:
    name: Suporte Vext
    email: suporte@usevext.com
servers:
  - url: https://api.usevext.com
    description: Produção
security:
  - apiKey: []
tags:
  - name: Cobranças
    description: Criação, consulta e estorno de cobranças PIX.
  - name: Saldo
    description: Quanto o vendedor tem e quanto pode sacar.
paths: {}
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: sk_live_… | sk_test_…
      description: |
        Chave secreta do vendedor, criada no painel em **Desenvolvedores**.

        O valor em claro existe uma única vez, na criação. Guardamos só o
        hash SHA-256 - nem o suporte consegue recuperá-lo, o que é o ponto:
        um dump do nosso banco não permite cobrar em nome de ninguém.

        A chave vai no **servidor**. Colocá-la no navegador do comprador a
        entrega a qualquer pessoa que abra a página.

````