PagSeguro – API Pix: Como Consultar Status de Cobrança

Introdução à Verificação de Cobranças no PagSeguro

Se você já utilizou o sistema de pagamentos do PagSeguro, sabe que uma das funcionalidades mais importantes é a verificação do status das cobranças. Neste artigo, vamos abordar como verificar o status de uma cobrança usando a API Pix do PagSeguro.

Como Funciona a API Pix do PagSeguro

A API Pix do PagSeguro é uma ferramenta poderosa que permite integrar pagamentos rápidos e seguros em seu sistema. Utilizando essa API, é possível consultar diversas informações, incluindo o status das cobranças feitas através do Pix. Para começar, é necessário ter um token de autenticação e seguir as diretrizes fornecidas na documentação oficial do PagSeguro.

Verificando o Status da Cobrança

Para verificar o status de uma cobrança específica, você deve fazer uma chamada à API informando o identificador da cobrança. A resposta retornada pela API incluirá detalhes como o valor pago, a data da transação e, principalmente, o status. Os status possíveis incluem “PENDING”, “COMPLETED” e “CANCELLED”, que indicam, respectivamente, se a transação está pendente, concluída ou cancelada.

Exemplo de Implementação

Na prática, a chamada para verificação do status poderia ser feita em uma linguagem como JavaScript ou Python. A resposta da API deve ser tratada para fornecer informações claras ao usuário final. Aqui está um exemplo de como a chamada pode ser estruturada:

const fetch = require('node-fetch');

const verificarStatus = async (idCobrança) => {
    const resposta = await fetch(`https://api.pagseguro.com/v2/cobrança/${idCobrança}`, {
        method: 'GET',
        headers: { 'Authorization': `Bearer ${SEU_TOKEN}` }
    });
    const dados = await resposta.json();
    return dados;
};

Com essa chamada, você poderá verificar rapidamente o status da cobrança desejada e tomar as ações necessárias, garantindo que seu processo de pagamento esteja sempre sob controle.