Consultar Status

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

import requests

url = "https://garu.com.br/api/transactions/status/{galaxPayId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://garu.com.br/api/transactions/status/{galaxPayId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://garu.com.br/api/transactions/status/{galaxPayId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://garu.com.br/api/transactions/status/{galaxPayId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://garu.com.br/api/transactions/status/{galaxPayId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://garu.com.br/api/transactions/status/{galaxPayId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

api

transactions

status

{galaxPayId}

Consultar Status

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

import requests

url = "https://garu.com.br/api/transactions/status/{galaxPayId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://garu.com.br/api/transactions/status/{galaxPayId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://garu.com.br/api/transactions/status/{galaxPayId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://garu.com.br/api/transactions/status/{galaxPayId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://garu.com.br/api/transactions/status/{galaxPayId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://garu.com.br/api/transactions/status/{galaxPayId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

const response = await fetch(
  'https://garu.com.br/api/transactions/status/987654'
);

const status = await response.text();
console.log(`Status: ${status}`); // "captured"

import requests

url = "https://garu.com.br/api/transactions/status/987654"
response = requests.get(url)
status = response.text

print(f"Status: {status}")  # "captured"

Resposta de Sucesso (200 OK)

"captured"

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

Status Possíveis

Status	Descrição	Pagamento Confirmado?
`pendingBoleto`	Boleto gerado, aguardando pagamento	Não
`pendingPix`	Código PIX gerado, aguardando pagamento	Não
`authorized`	Cartão de crédito autorizado	Não
`captured`	Pagamento com cartão capturado	Sim
`payedBoleto`	Pagamento via boleto confirmado	Sim
`payedPix`	Pagamento via PIX confirmado	Sim
`denied`	Pagamento negado	Não
`reversed`	Pagamento estornado/reembolsado	Não
`cancel`	Transação cancelada	Nã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

Detalhes da Transação Reembolsar Transação

​Visão Geral

​Exemplo de Requisição

​Resposta de Sucesso (200 OK)

​Status Possíveis

​Exemplo: Verificação de Pagamento

​Quando Usar Este Endpoint

​Próximos Passos

Detalhes da Transação

Webhooks

Visão Geral

Exemplo de Requisição

Resposta de Sucesso (200 OK)

Status Possíveis

Exemplo: Verificação de Pagamento

Quando Usar Este Endpoint

Próximos Passos