Listar um pagamento específico

Fala, desenvolvedor! Desta vez vou mostrar pra você como você procura por uma iniciação de pagamento específica utilizando o paymentId 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:

Escopos	Descrição
`openid`	Consultar perfil do usuário
`empresas.btgpactual.com/payments`	Permite criar e consultar pagamentos.

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

Endpoint sandbox	Endpoint produção
https://api.sandbox.empresas.btgpactual.com/30306294000145/banking/payments/{{paymentId}}	<https://api.empresas.btgpactual.com/{{companyId}}/banking/payments/{{paymentId}}

Campo `companyId`

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

Campo `paymentId`

O paymentId é um parâmetro obtido por meio da listagem de pagamentos pendentes de aprovação e representa uma única iniciação de pagamento.

Iniciando

Para listarmos um pagamento específico, 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 e um paymentId válido;

Após realizar a requisição, você receberá como retorno o objeto com os dados referentes à iniciação de pagamento que requisitou: