Estorno Cartão

Consultar status do estorno

Consulta se um estorno de cartão foi confirmado.

GET/v1/wallet/refunds

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Use o refund (não o status da cobrança) para confirmar:

status === "CONFIRMED" (ou success === true): estorno confirmado
status === "PROCESSING": ainda aguardando
status === "ERROR": falhou (error pode vir preenchido)

Modos de uso: informe um identificador na query string (não há body):

?refundId=ref_...: detalhe/polling de um estorno específico.
?chargeId=cha_...: estornos da cobrança de cartão.

MasterAccounts podem consultar uma subconta acrescentando accountId à query (ex.: ?chargeId=cha_...&accountId=429131213).

Se vierem os dois, só o refundId é usado.

A resposta é sempre uma lista em items, mesmo na consulta por refundId. Se não houver estorno, items vem vazio.

ℹ️ No estorno de cartão a resposta traz paymentType: "CREDIT_CARD" e endToEndId: null.

Authorizations

bearer

Authorization

string obrigatório

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

wallet/read

Query Parameters

refundIdopcional

Detalhe/polling de um estorno específico

ref_1774531490865_bq4e8v12x

chargeIdopcional

Lista os estornos da cobrança de cartão

cha_1774530966959_frgj3ptax

accountIdopcional

(M2M) Filtra pela subconta

429131213

← Anterior

Criar estorno de cartão

Criar Cliente

const url = 'https://sandbox.validapay.com.br/v1/wallet/refunds?refundId=ref_1774531490865_bq4e8v12x';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200Sucesso▾

JSON

{
    "items": [
        {
            "refundId": "ref_1790546300126_b16nwgz21",
            "accountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
            "status": "CONFIRMED",
            "success": true,
            "amount": 1,
            "reason": "CUSTOMER_REQUEST",
            "chargeId": "SANDBOX_cha_1790534100343_osf6bm91p",
            "endToEndId": null,
            "paymentType": "CREDIT_CARD",
            "splitReversals": [],
            "error": null,
            "createdAt": "2026-09-27T21:58:20.126Z"
        }
    ]
}

200Nenhuma devolução encontrada▾

JSON

{
    "items": []
}

← Anterior

Criar estorno de cartão

Criar Cliente