Cash In

Consultar Transação

GET/v1/transactions/{transaction_id}

Recupera os detalhes completos de uma transação existente pelo seu ID único.

Parâmetros de URL

Campo	Tipo	Descrição
`transaction_id`obrigatório	`string (UUID)`	Identificador único da transação retornado no momento da criação.

Campos da Resposta

Campo	Tipo	Descrição
`id`	`string`	Identificador único da transação (UUID)
`external_id`	`string \| null`	Referência interna informada na criação
`status`	`TransactionStatus`	Status atual da transação
`amount`	`number`	Valor da transação em BRL
`payment_method`	`string`	Método de pagamento utilizado
`customer`	`object`	Dados completos do cliente incluindo endereço
`created_at`	`string (ISO 8601)`	Data e hora de criação da transação

Status Possíveis

PENDINGAguardando pagamento

AUTHORIZEDPagamento confirmado

FAILEDFalha no processamento

CHARGEBACKContestação iniciada

IN_DISPUTEEm processo de disputa

Erros Possíveis

401API Secret ausente ou inválido

404Transação não encontrada para o ID informado

GEThttps://api.genesys.finance/v1/transactions/{transaction_id}

Headers

api-secret: seu_api_secret_aqui
Content-Type: application/json

cURL

curl -X GET "https://api.genesys.finance/v1/transactions/c22dc7e1-8b10-4580-9dc4-ebf78ceca475" \
  -H "api-secret: seu_api_secret_aqui" \
  -H "Content-Type: application/json"

Response 200

{
  "id": "c22dc7e1-8b10-4580-9dc4-ebf78ceca475",
  "external_id": "pedido_12345",
  "status": "PENDING",
  "amount": 100.50,
  "payment_method": "PIX",
  "customer": {
    "name": "João Silva",
    "email": "joao.silva@exemplo.com",
    "phone": "11999999999",
    "document": "12345678901"
  },
  "created_at": "2024-01-15T10:30:00.000Z"
}