Consulta as capacidades (entitlements) das assinaturas vivas de um cliente — o que liberar no seu SaaS. Informe external_id OU email.

Lista as assinaturas do tenant. Filtros opcionais por status (CSV), offer_slug, e paginação por cursor (limit, after).

Estado atual de UMA assinatura (qualquer status). Útil para reconciliar um webhook perdido.

Timeline do que o gateway respondeu para uma assinatura (aprovação/recusa/estorno/chargeback).

Detalhe de um pagamento, com a decomposição em items (plano/bump/juros).

Todas as assinaturas de um cliente (qualquer status), pelo seu external_id.

Histórico de pagamentos de um cliente (recorrente + avulso), paginado por cursor.

Código/link de indicação de um cliente + recompensa e progresso. Informe external_id OU email.

Link de renovação de um cliente numa campanha (cria-ou-obtém, idempotente). Exige escopo write.

Lista todos os links de uma campanha de renovação (cursor).

Link público de pagamento da fatura EM ABERTO de uma assinatura. 409 se não há fatura aberta.

Link de re-acesso ao Pix de um pedido pendente (compra avulsa OU adiantamento de renovação) — a 2ª via para reenviar ao cliente. 409 se não há Pix pendente para reabrir.

Cria uma assinatura SEM cartão (Pix manual ou migração). Idempotente por (cliente, oferta). Escopo write.

Troca o plano de uma assinatura (upgrade imediato com proração; downgrade/troca de ciclo agendados). Escopo write.

Cancela uma troca de plano AGENDADA. 422 se não houver troca agendada. Escopo write.

Cancela uma assinatura (terminal, idempotente). 422 se houver QR Pix pagável. Escopo write.

Enfileira uma cobrança imediata no cartão salvo da assinatura (202). Escopo write.

Reagenda a próxima cobrança (NÃO cobra). next_billing_at deve ser futuro (ISO-8601). Escopo write.

Remove o cupom dos ciclos futuros de uma assinatura. Escopo write.

Gera um link de renovação avulsa (expira em 7 dias). Escopo write.

Gera um link para o cliente trocar de forma de pagamento (cartão/Pix), sem cobrança, single-use, 7 dias. Escopo write.

Estorna um pagamento (total/parcial). Se atingir runway pré-pago, retorna 422 requires_confirmation=runway; reenvie com confirm_runway=true. Escopo write.

Atualiza nome/email/telefone de um cliente (doc e external_id não são editáveis). Escopo write.

Atualiza o e-mail de um cliente (sincroniza com o gateway). Escopo write.