Skip to content

Verifica se as transações do pedido permitem estorno automático

Request

Analisa as transações de pagamento do pedido e informa se o estorno pode ser executado automaticamente na plataforma de e-commerce/adquirente, sem intervenção manual do time de atendimento.

Por que existe

Estorno automático não depende só da conta estar habilitada: depende do meio de pagamento (boleto e Pix normalmente não permitem), do prazo desde a compra (adquirentes limitam o estorno no cartão a uma janela de dias) e do valor. Este endpoint concentra essas verificações.

Como o front Genius usa

O front chama este endpoint (EstornoPorItemVerificarAutomatico) antes de calcular os valores, com executarRegras: true, e guarda o resultado. Quando é false, a interface não promete "estorno automático em até X dias" — em vez disso informa que o reembolso passará por análise, evitando frustração e chamado no SAC.

Diferença para verificar-elegibilidade-estorno-automatico

  • Este: parte das transações já conhecidas (multi-pagamento, por item). É o usado no fluxo de estorno por item.
  • O outro: parte do pedido inteiro e de um valor. É o usado no fluxo clássico.
Security
BearerAuth
Query
lojaVirtualIdinteger or null, (int64)

Id da loja virtual (subconta), quando a conta opera múltiplas lojas.

Bodyapplication/jsonrequired
TransacoesArray of objects(TransacaoEcommDTO)required

Transações de pagamento do pedido original.

ExecutarRegrasboolean

true aplica as regras de valor e de DataPermitida na verificação (uso padrão). false verifica apenas a compatibilidade do meio de pagamento.

DataPermitidastring or null, (date-time)

Data-limite para uso do estorno automático no cartão.

ValorEstornonumber, (double)

Valor pretendido do estorno. Use 0 para verificar apenas se a modalidade é possível, independentemente do valor.

curl -i -X POST \
  'https://apidocs.geniusreturns.com.br/_mock/openapi/v1/pvt/financeiro/verificar-permissao-estorno-automatico-por-item?lojaVirtualId=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Transacoes": [
      {
        "tid": "1234567890abc",
        "ativa": true,
        "pagamentos": [
          {
            "valor": 219.8,
            "tipoPagamento": 1
          }
        ]
      }
    ],
    "ExecutarRegras": true,
    "DataPermitida": "2026-11-30T00:00:00Z",
    "ValorEstorno": 0
  }'

Responses

Verificação concluída.

Bodyapplication/json
dataHoraRespostastring, (date-time)

Data e hora da resposta, em UTC.

registrosinteger, (int32)

Quantidade de registros retornados em entidade.

httpStatusstring

Código HTTP da resposta, em texto.

erroCodigostring or null

Código do erro, quando houver.

erroDescricaostring or null

Mensagem do erro, quando houver.

erroDetalhadostring or null

Detalhamento técnico do erro, quando houver.

erroTipostring or null

Classificação do erro. Útil para distinguir falha de integração com a plataforma de e-commerce (04) de erro de domínio ou erro comum (00).

entidadeboolean

Resultado da verificação.

Response
{
  "dataHoraResposta": "2026-09-18T13:41:07.003Z",
  "registros": 1,
  "httpStatus": "200",
  "entidade": true
}