Estorno Cartão

Consultar status do estorno

Consulta se um estorno de cartão foi confirmado.

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 refundId para o detalhe/polling de um estorno específico.
Informe chargeId para consultar os estornos daquela cobrança de cartão.
MasterAccounts podem consultar uma subconta informando accountId.

ℹ️ No estorno de cartão a resposta traz paymentType: "CREDIT_CARD" e o providerChargeId da transação.

GET/v1/wallet/refunds

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

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

Authorizations

bearer

Authorization

string · header · required

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

Escopos requeridos

wallet/read

Query Parameters

Name	Type	Value	Required	Description
refundId	-	ref_1774531490865_bq4e8v12x	Optional	- Detalhe/polling de um estorno específico

← Anterior

Criar estorno de cartão

Criar Cliente

const url = 'https://sandbox.validapay.com.br/v1/wallet/refunds?refundId=ref_1774531490865_bq4e8v12x?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

200Item único (por refundId)

{
    "refundId": "ref_1774531490865_bq4e8v12x",
    "accountId": "429131212",
    "status": "CONFIRMED",
    "success": true,
    "amount": 100.00,
    "reason": "CUSTOMER_REQUEST",
    "chargeId": "cha_1774530966959_frgj3ptax",
    "originalEndToEndId": null,
    "returnIdentification": null,
    "providerChargeId": "prov_ch_9f8a7b6c",
    "paymentType": "CREDIT_CARD",
    "splitReversals": [],
    "error": null,
    "createdAt": "2026-03-26T13:24:52.106Z",
    "updatedAt": "2026-03-26T13:24:57.553Z"
}

404404 REFUND_NOT_FOUND

{
    "error": {
        "message": "Refund não encontrado",
        "code": "REFUND_NOT_FOUND",
        "details": null,
        "timestamp": "2026-08-05T12:00:00.000Z"
    }
}

← Anterior

Criar estorno de cartão

Criar Cliente