Gerar Recibo
Fala, desenvolvedor. Neste tutorial vou mostrar como você pode gerar o recibo de um pagamento já efetuado.
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 no fluxo de autorização:
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
Campo companyId
companyId
Esse dado é o CNPJ da conta que deseja operar. Muito provavelmente é sua conto ou do seu empregador.
Campo paymentId
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 gerarmos o recibo, basta:
- Configurar a autorização para bearer token e passar nosso Access Token válido;
- Realizar uma requisição
GET
para o endpoint passando ocompanyId
correto e umpaymentId
válido;
Após isso, você receberá como response um PDF referente ao recibo da transação que consultou
Updated 10 months ago