Listar pagamentos

Fala, desenvolvedor! Desta vez vou mostrar pra você como você lista as iniciações de pagamento por meio da API de pagamentos do BTG Pactual Empresas!

Importante

• A API de pagamentos não transfere dinheiro imediatamente entre contas.
• Visite O que são os pagamentos? para conhecer o ciclo de vida dos pagamentos
• Operamos por meio da criação de uma instância de pagamento que necessita ser aprovada manualmente na conta.
• Para ver mais informações sobre pagamentos, visite nossa página na documentação: Pagamentos.

Escopos

Para acessar os produtos desta API, é necessário que sejam enviados os seguintes escopos:

Fluxo autorização

Essa API utiliza o Access Token obtido através do Auth Code Flow. Temos um tutorial de como você gera esse código e gera um Access Token com ele Aqui

Endpoint

Campo companyId

Esse dado é o CNPJ da conta que deseja operar. Muito provavelmente é sua ou do seu empregador direto.

Iniciando

Para listar as iiniciações de pagamento criadas, basta:

• Configurar a autorização para bearer token e passar nosso Access Token válido;
• Realizar uma requisição GET para o endpoint passando o companyId correto:

Após realizar a requisição, você receberá como response um array de objetos data contendo as informações das instâncias de pagamento. Tome cuidado pois existem várias informações sensíveis aqui:

Perceba que no fim a API nos devolve o endpoint contendo o cursos correspondente a essa instância especifica, permitindo que você tenha facil acesso a ela no seu desenvolvimento.