Também estou com essa dúvida. Mas pelo o que eu estou sacando, funciona mais ou menos assim:
- vc recebe uma notificação em uma url que você cadastrou quando criou a assinatura. essa notificação tem só um token.
- com esse token, você vai na url /notification/[token] e pede as alterações. Aí vc recebe um array de objetos como esse da imagem
- Ali o rosa é o tipo de cada notificação. Se for "subscription_charge", significa que é uma modificação relativa a uma cobrança da assinatura.
- No amarelo você vê o status da cobrança e no azul vc tem o id dela. Aí se current for new, vc já sabe que uma nova cobrança acabou de ser gerada. Se for waiting, já sabe que a forma de pagamento foi definida e agora está agurdando a confirmação. Essa variação de new e waiting é no mesmo instante quando a assinatura já existe. Ela faz mais sentido quando você cria a assinatura e ainda não definiiu como será o meio de pagamento dela. Quando você usa o one-step é tudo junto.
Termos mais procurados: