Verificação de Status Unificado - Kavro Pay

Como Funciona o Status Unificado?Este endpoint aceita o parâmetro idtransaction e busca automaticamente se pertence a uma Cobrança PIX ou a um Saque PIX, consultando em tempo real:ID Interno (PAY... ou WIT...) • ID da Adquirente • externalReference (seu ID de pedido)

GET /v1/status?idtransaction={id} • escopo payments:read

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
`idtransaction`	string	Sim	ID da transação (ex: PAY…, WIT…, ID externo do pedido ou txId da adquirente).

curl "https://api.kavropay.online/v1/status?idtransaction=PAY9B1DEB4D3B7D4BAD9BDD2B" \
  -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI"

const id = 'PAY9B1DEB4D3B7D4BAD9BDD2B';
const res = await fetch(`https://api.kavropay.online/v1/status?idtransaction=${id}`, {
  headers: { 'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI' }
});
const data = await res.json();
console.log('Status Atual:', data.status); // 'paid', 'waiting_payment', 'paid_out', etc.

<?php
$id = 'PAY9B1DEB4D3B7D4BAD9BDD2B';
$ch = curl_init("https://api.kavropay.online/v1/status?idtransaction=" . urlencode($id));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer sk_live_SUA_CHAVE_AQUI']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Status: " . $res['status'];

import requests
id_tx = 'PAY9B1DEB4D3B7D4BAD9BDD2B'
res = requests.get(f'https://api.kavropay.online/v1/status?idtransaction={id_tx}',
    headers={'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI'}
)
print('Status:', res.json()['status'])

Resposta Rápida (HTTP 200 OK)

{
  "id": "PAY9B1DEB4D3B7D4BAD9BDD2B",
  "status": "paid"
}

Anterior: Cobranças PIX

Próximo: Gestão de Clientes