PagamentosVerificar Pagamento

Verificar Pagamento

Consulta o status de uma cobrança pelo txid. Use pra saber se o cliente pagou.


Endpoint

POST https://isolutionpay.com/api/pix

Campos

CampoObrigatórioDescrição
txidID retornado ao criar a cobrança

Exemplos

curl -X POST https://isolutionpay.com/api/pix \
  -H "Content-Type: application/json" \
  -H "token: isolutionpay_sk_SUA_CHAVE_AQUI" \
  -d '{ "txid": "abc123xyz" }'
const res = await fetch("https://isolutionpay.com/api/pix", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "token": "isolutionpay_sk_SUA_CHAVE_AQUI"
  },
  body: JSON.stringify({ txid: "abc123xyz" })
});
 
const { status } = await res.json();
 
if (status === "CONCLUIDA") {
  // Pago — libere o acesso
}

Resposta

{
  "success": true,
  "txid": "abc123xyz",
  "status": "CONCLUIDA"
}

Status possíveis

StatusSignificado
pendingAinda não foi pago — continue consultando
CONCLUIDAPago ✅ — pode liberar o acesso
cancelledExpirou ou foi cancelado — crie uma nova cobrança

Polling automático

const poll = setInterval(async () => {
  const res = await fetch("https://isolutionpay.com/api/pix", {
    method: "POST",
    headers: { "Content-Type": "application/json", "token": "isolutionpay_sk_SUA_CHAVE_AQUI" },
    body: JSON.stringify({ txid: "abc123xyz" })
  });
 
  const { status } = await res.json();
 
  if (status === "CONCLUIDA") { clearInterval(poll); liberarAcesso(); }
  if (status === "cancelled") { clearInterval(poll); }
}, 5000);
 
setTimeout(() => clearInterval(poll), 60 * 60 * 1000);

Prefere notificação automática?

Configure um Webhook no painel e receba um POST automático quando o pagamento for confirmado — sem precisar de polling.