Guia de Consulta de Transações

GET /transactions/{id}

curl --request GET \
  --url https://api.econpay.com.br/transactions/225 \
  --header 'Authorization: Bearer SEU_TOKEN'

{
  "id": 225,
  "status": 1,
  "status_payment_name": "PENDING",  // Nome legível
  "amount": 500,
  "type": "pix",
  "customer": { ... },
  "acquirer_status": null  // Não consulta na Firebank
}

GET /transactions/{id}?payment_type={TIPO}

curl --request GET \
  --url 'https://api.econpay.com.br/transactions/225?payment_type=PIX' \
  --header 'Authorization: Bearer SEU_TOKEN'

{
  "id": 225,
  "status": 2,
  "status_payment_name": "APPROVED",  // ✅ Nome legível
  "amount": 500,
  "type": "pix",
  "customer": { ... },
  "acquirer_status": {
    "id": "ee1456c0-66da-4eac-9f80-96fefb3e7f3b",
    "operation": {
      "status": "PAID",  // Status na Firebank
      "value": 5,
      "provider": "celcoin"
    },
    "history": [
      {
        "status": "WAITING_PAYMENT",
        "createdAt": "2025-10-28T21:59:45.068Z"
      },
      {
        "status": "PAID",
        "createdAt": "2025-10-28T22:00:04.192Z"
      }
    ],
    "payer": {
      "fullName": "João da Silva",
      "document": "***380023**"
    }
  }
}

async function checkPixPayment(transactionId) {
  const response = await fetch(
    `https://api.econpay.com.br/transactions/${transactionId}?payment_type=PIX`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );
  
  const transaction = await response.json();
  
  // Status já vem sincronizado - usando nome legível
  if (transaction.status_payment_name === 'APPROVED') {
    console.log('✅ Pagamento aprovado!');
    console.log('Pago por:', transaction.acquirer_status.payer.fullName);
    console.log('Valor:', `R$ ${transaction.amount / 100}`);
    return true;
  }
  
  if (transaction.status_payment_name === 'PENDING') {
    console.log('⏳ Aguardando pagamento...');
    return false;
  }
  
  console.log('❌ Pagamento falhou');
  return false;
}

// Uso
const isPaid = await checkPixPayment(225);

async function getPaymentHistory(transactionId) {
  const response = await fetch(
    `https://api.econpay.com.br/transactions/${transactionId}?payment_type=PIX`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );
  
  const transaction = await response.json();
  
  if (transaction.acquirer_status?.history) {
    console.log('📜 Histórico de Status:');
    transaction.acquirer_status.history.forEach(event => {
      const date = new Date(event.createdAt).toLocaleString('pt-BR');
      console.log(`${date} - ${event.status}`);
    });
  }
}

async function syncPendingTransactions(transactionIds) {
  const results = await Promise.all(
    transactionIds.map(id =>
      fetch(
        `https://api.econpay.com.br/transactions/${id}?payment_type=PIX`,
        {
          headers: { 'Authorization': `Bearer ${token}` }
        }
      ).then(r => r.json())
    )
  );
  
  const approved = results.filter(t => t.status_payment_name === 'APPROVED');
  const pending = results.filter(t => t.status_payment_name === 'PENDING');
  
  console.log(`✅ ${approved.length} aprovadas`);
  console.log(`⏳ ${pending.length} pendentes`);
  
  return { approved, pending };
}

// Sincronizar transações pendentes
const { approved, pending } = await syncPendingTransactions([225, 226, 227]);

GET /transactions/{id}?payment_type=PIX