Histórico de mensagens em assinaturas

Seria dessa forma mesmo. Realizando essa etapas, você chega no subscription_id.
Ja encaminhamos a sugestão para nossa equipe responsável.

Opa. Entendi, obrigado. Então dessa forma pode funcionar:

1. Fazemos um request para o endpoint /v1/charges?charge_type=subscription&begin_date=2024-02-18&end_date=2025-02-18&customer_document=... para retornar todas as cobranças efetuadas pelo usuário dentro de uma ou mais assinaturas;
2. Fazemos múltiplos requests para o endpoint /v1/charge/:id para cada uma das cobranças retornadas anteriormente a fim de buscar o subscription_id de cada uma delas;
3. Eliminamos os subscription_id duplicados e consultamos cada um deles no endpoint /v1/subscription/:id.

Não é um workflow dos mais diretos/simples.... Então reforço mais solicitação de ser possível buscar assinaturas pelo custom_id.

Boa tarde @bgeneto ! Esse endpoint vai retornar as cobranças vinculadas àquela assinatura. Aí você pode pegar o charge_id retornado nesse endpoint e consumir o endpoint de consultar cobrança pelo charge_id, que vai te retornar todas as informações (plan_id, subscription_id, status....). Logo, nessa segunda etapa você obtém o subscription_id para realizar o cancelamento.

@guilherme_efi Se pelo menos houvesse um endpoint que listasse os detalhes de uma assinatura pelo seu custom_id já ajudava.

Obrigado pela resposta, mas infelizmente temos um sistema que não guardou a informação (subscription_id) retornada apenas na hora de criação das assinaturas!
Assim, na minha visão, há um enorme buraco que precisa ser tapado na API da Efí... pois nenhum endpoint (AFAIK) lista o subscription_id.
O endpoint mencionado (/v1/charges?charge_type=subscription) lista apenas as cobranças relacionadas à assinatura, com os seus respectivos id de cobrança (e não id de assinatura).
Em resumo: é impossível cancelar, editar ou mesmo listar as assinaturas de um usuário depois de criada se você não guardou o subscription_id ... falha grave na minha opinião pois a API deveria ser autossuficiente. E agora?

Bom dia, @bgeneto.
Essa assinatura foi emitida pela API? Se sim, é provável que o sistema do cliente tenha essa informação.
Você pode também usar o endpoint de listar as cobranças. Apesar de haver um problema ao buscar documentos que começam com 0 — que nossa equipe já está resolvendo —, dá para contornar essa falha na SDK de PHP colocando o CPF entre aspas simples e duplas, assim: "'03973638004'", até que lancemos a correção.

Bom dia! Para cancelar uma assinatura eu preciso do subscription_id, certo? E como eu faço para obtê-lo? Digo, como buscar na API o subscription_id da assinatura de um cliente? Grato!

Fiquei tão abismado e frustrado quanto o @jonesheckler. Pessoal, não ter essa informação na documentação é um desrespeito... passei 2 semanas desenvolvendo um produto para só agora descobrir que não é possível integrar com as cobranças que o cliente já tem - algo tão básico! Vou sair mega queimado e provavelmente terei um mega retrabalho para recriar as cobranças todas via API sem poder cobrar do cliente...