Criar uma requisição de pagamento consiste em fazer uma chamada à API de Pagamentos do PagSeguro, informando os dados de uma compra a ser realizada em sua loja. Esses dados da compra podem ser por exemplo os produtos que serão vendidos bem como os dados do comprador que está navegando.
Para informar esses dados, seu sistema deve fazer uma requisição à API de Pagamentos do PagSeguro que irá armazenar os dados e retornar um código de requisição.
Com o código de requisição em mãos, sua loja ou aplicação será capaz de direcionar o comprador ao PagSeguro onde ele realizará o pagamento dos itens previamente informados. Dessa maneira seu sistema irá oferecer maior segurança e flexibilidade, pois os dados do pagamento serão informados via API diretamente pelo seu sistema e não irão trafegar pelo navegador do usuário na internet.
Nesse contexto a classe PaymentRequest da biblioteca é responsável por criar uma requisição de pagamento de maneira prática: você apenas informa os dados do pagamento e logo após executa o método register que lhe devolve a URL necessária para direcionar seu comprador ao ambiente seguro onde ele realizará o pagamento.
Para melhor entendimento, vamos exemplificar a criação de uma requisição de pagamento com o seguinte cenário:
- O comprador navega pela loja e decide comprar um notebook na cor prata no valor de R$ 2.430,00 e uma mochila no valor de R$ 150,99.
- Sua loja requisita os dados do comprador, p.e., nome completo, e-mail e telefone bem como os dados do endereço de envio.
- Ainda na loja o comprador escolhe pagar com PagSeguro.
Com essas informações em mãos você deve criar um objeto do tipo PaymentRequest:

Agora você deve adicionar os produtos ao objeto criado:

Você também pode informar os dados fornecidos pelo comprador em sua loja, assim, o comprador não precisará informar esses dados novamente no site do PagSeguro:

Informe o endereço de envio fornecido pelo comprador, assim, o comprador não precisará informa-lo novamente no site do PagSeguro:

É necessário que você informe a moeda em que o comprador irá realizar o pagamento. No momento, a única opção disponível é BRL (Real).

É necessário informar também o tipo de frete da compra, veja mais detalhes na classe Shipping:

Caso o seu sistema utilize um código de referência para cada compra que é feita em sua loja, você pode utiliza-lo para vincular a uma transação no PagSeguro:

Agora que você informou os dados da compra, você deve executar o método register, que faz a requisição à API de Pagamentos do PagSeguro, retornando a URL necessária para o comprador fazer o pagamento:

Com a URL em mãos você pode direcionar o comprador ao PagSeguro, para que ele faça o pagamento em ambiente seguro (HTTPS). Veja todas as opções da classe PaymentRequest na página de classes da biblioteca.
Obs.: o método register faz uma chamada via API, para isso é necessário informar as credenciais utilizando um objeto do tipoAccountCredentials. Se você deseja utilizar credenciais previamente definidas no arquivo de configurações, veja como utilizar o método getAccountCredentials da classe PagSeguroConfig.
Tem alguma dúvida sobre como integrar o PagSeguro? Entre em contato.