These docs are for v1.0. Click to read the latest docs for v4.1.

Listar ordens de pagamento

A cada intervalo de recorrência nos planos automáticos, o PagSeguro irá gerar uma Ordem de Pagamento. Ela indica a necessidade de cobrança da próxima parcela. Na data de vencimento da ordem de pagamento, será gerada uma Transação, que é a cobrança dessa ordem.

Se a transação for bem sucedida, a Ordem de Pagamento fica com o status 5 (Paga). Caso contrário, podem ser geradas novas tentativas de cobrança, através de novas Transações, dentro da mesma Ordem de Pagamento.

Com este método é possível verificar todas as Ordens de Pagamento geradas para uma adesão, bem como as Transações associadas a cada Ordem de Pagamento. A partir destes dados pode-se verificar se as cobranças foram efetuadas ou não, e por qual motivo.

Para listar as ordens de pagamento de uma adesão, utilize o método /pre-approvals/{{preApprovalCode}}/payment-orders.
GET https://ws.pagseguro.uol.com.br/pre-approvals/{preApprovalCode}/payment-orders?{{autenticação}}

O parâmetro preApprovalCode é o código da adesão obtido no método /pre-approvals já documentado em Adesão ao plano

O retorno deste método pode ser paginado, verifique na referência da API os parâmetros de entrada.

Os status de ordem de pagamento podem ser vistos na Tabela de Status de Ordem de Pagamento

Os status das transações podem ser vistos na Tabela de Status de Transação.