Ativar a assinatura pelo seu próprio checkout

Se preferir coletar o cartão na sua interface, use as rotas abaixo com o paymentGuid. São públicas e usam a mesma chave e padding da seção Montar o seu próprio checkout.

GET/api/v1/subscription-checkout/:guidPúblico

{
  "status": "success",
  "data": {
    "paymentGuid": "1da43ec5-306e-44a9-8870-da557a0f41a9",
    "status": 3,
    "value": 1990,
    "amount": 19.9,
    "cycle": "MONTHLY",
    "nextDueDate": "2026-10-15",
    "endDate": null,
    "description": "",
    "payerName": "Maria Oliveira",
    "merchantName": "Loja Homolog Pag"
  }
}

Expõe só o necessário para montar a tela. Um GUID inexistente devolve 404 em JSON.

PUT/api/v1/subscription-checkout/:guid/payPúblico

{ "encryptedCardData": "base64_da_criptografia_RSA..." }

• Concluída a chamada, a assinatura passa a ACTIVE. Se o vencimento for hoje, a primeira cobrança sai na hora — confira lastChargeStatus na resposta, como na seção Criar assinatura com cartão.
• As validações de cartão da seção Criar assinatura com cartão valem aqui, com as mesmas mensagens 400.
• Cartão recusado na tokenização devolve 422 CARD_REJECTED e a assinatura continua PENDING_PAYMENT — o pagador pode tentar com outro cartão.
• Uma assinatura que já não está PENDING_PAYMENT devolve 409.