Skip to main content
GET
/
api
/
transactions
/
status
/
{galaxPayId}
Consultar Status
curl --request GET \
  --url https://garu.com.br/api/transactions/status/{galaxPayId} \
  --header 'Authorization: Bearer <token>'

​
Visão Geral

Este é um endpoint público (não requer autenticação) que retorna apenas o status de uma transação. Use quando precisar apenas verificar se um pagamento foi confirmado, sem os detalhes completos.
Este endpoint usa o galaxPayId (ID do gateway de pagamento), não o ID interno da transação.

​
Exemplo de Requisição

curl -X GET https://garu.com.br/api/transactions/status/987654

​
Resposta de Sucesso (200 OK)

"captured"
A resposta é uma string simples com o status da transação.

​
Status Possíveis

StatusDescriçãoPagamento Confirmado?
pendingBoletoBoleto gerado, aguardando pagamentoNão
pendingPixCódigo PIX gerado, aguardando pagamentoNão
authorizedCartão de crédito autorizadoNão
capturedPagamento com cartão capturadoSim
payedBoletoPagamento via boleto confirmadoSim
payedPixPagamento via PIX confirmadoSim
deniedPagamento negadoNão
reversedPagamento estornado/reembolsadoNão
cancelTransação canceladaNão

​
Exemplo: Verificação de Pagamento

async function isPaid(galaxPayId) {
  const response = await fetch(
    `https://garu.com.br/api/transactions/status/${galaxPayId}`
  );

  const status = await response.text();
  const paidStatuses = ['captured', 'payedBoleto', 'payedPix'];

  return paidStatuses.includes(status.replace(/"/g, ''));
}

// Uso
if (await isPaid(987654)) {
  console.log('Pagamento confirmado!');
  // Liberar acesso
} else {
  console.log('Pagamento ainda não confirmado');
}

​
Quando Usar Este Endpoint

  • Página de confirmação: Verificar se o pagamento foi confirmado após redirecionamento
  • Polling: Verificar periodicamente o status de um pagamento pendente
  • Integrações simples: Quando não precisa de detalhes, apenas do status
Para obter informações completas da transação (cliente, produto, valor), use o endpoint Detalhes da Transação.

​
Próximos Passos

Detalhes da Transação

Obtenha informações completas da transação

Webhooks

Receba notificações em tempo real