Como é cobrado o uso da API?

A API da Cathopic utiliza um modelo de cobrança “pay-as-you-go” (pague conforme o uso), baseado no uso real do conteúdo pelos seus utilizadores finais. Todos os termos de faturação são regidos pelo nosso Contrato de Licença da API.

Dois modelos de cobrança

A cobrança depende de como os seus utilizadores finais consomem o conteúdo:

1. Uso no website (modelo de Dias de Uso)

• Aplica-se quando o conteúdo é exibido em websites, blogs ou aplicações web

• É calculado por dia de calendário em que um utilizador final acede a um conteúdo específico

• Fórmula: Total de Dias de Uso × (taxa mensal negociada ÷ 30)

• A cobrança diária proporcional garante que você paga apenas pelo uso real

• É registado separadamente por utilizador final e por item de conteúdo

2. Uso por email (modelo por Email)

• Aplica-se quando o conteúdo é incorporado em mensagens de email

• É cobrado por mensagem de email enviada (não por destinatário)

• Cobrança única por email que inclui o conteúdo

• Taxa negociada durante a configuração do acesso à API

Como a cobrança começa e termina

Conteúdo com marca d’água é gratuito

• O conteúdo aparece inicialmente com uma marca d’água

• A pré-visualização com marca d’água não gera cobranças

• Ideal para permitir que os utilizadores finais naveguem antes de se comprometerem

• Pode ser usado para testes e fins de avaliação

A cobrança começa quando a marca d’água é removida

1. O utilizador final decide usar o conteúdo sem marca d’água

2. A sua aplicação chama POST /confirm com:

   • media_id: O identificador do conteúdo

   • usage_type: “website” ou “email”

   • client_identifier: O ID único do seu utilizador final

3. A API devolve URLs permanentes para o conteúdo sem marca d’água

4. A cobrança começa imediatamente a partir deste momento

5. Você deve armazenar essas URLs e os dados de uso para o acompanhamento da faturação

A cobrança termina quando o conteúdo é removido

1. O utilizador final remove ou deixa de usar o conteúdo

2. A sua aplicação chama POST /remove com:

   • media_id: O identificador do conteúdo

   • client_identifier: O ID do utilizador final

3. A cobrança para esse uso específico é interrompida

4. Você deve apagar as URLs do conteúdo sem marca d’água da sua base de dados

Exemplo de cobrança no website

Suponha que você tenha negociado uma taxa mensal de para uso ilimitado do conteúdo:

• Cenário: A Paróquia A exibe a Imagem n.º 12345 na sua página inicial

• Dia 1: Você chama /confirm → A cobrança começa

• Dias 1-15: A imagem permanece na página inicial (15 dias de uso)

• Dia 16: A Paróquia remove a imagem, você chama /remove → A cobrança termina

• Cálculo: 15 dias × ( ÷ 30 dias) =

• Cobrado: para este uso específico

Se a Paróquia B também usar a mesma imagem por 10 dias, isso é registado separadamente e adiciona mais cobrança.

Exemplo de cobrança por email

Suponha que você tenha negociado uma taxa de --.05 por email:

• Cenário: Um Ministério envia uma newsletter com a Imagem n.º 67890

• Ação: Você chama /confirm com usage_type: "email"

• Resultado: Cobrança única de --.05 por aquele email

• Destinatários: Não importa se foi enviado para 100 ou 10.000 pessoas

• Cobrado: --.05 total (não por destinatário)

Limites mensais de cobrança

O seu acordo pode incluir limites mensais de cobrança:

• Protege-o contra faturas inesperadamente altas

• Quando o limite é atingido, o uso adicional pode ser gratuito ou com taxa reduzida

• O valor específico do limite é negociado durante a configuração do acesso à API

• Aplica-se ao total das cobranças mensais em todos os utilizadores finais

Faturação e pagamento

Calendário de faturas

• Faturas emitidas mensalmente nos primeiros 10 dias de cada mês

• Cobre todo o uso do mês anterior

• Detalhamento do uso por utilizador final e por item de conteúdo

• Enviadas para o endereço de email associado à sua conta de API

Processamento de pagamentos

• Pagamentos processados exclusivamente através da Stripe

• Cobrança automática para o seu método de pagamento registado

• É necessário manter, em todos os momentos, informações de pagamento válidas

• Recibos fornecidos automaticamente após um pagamento bem-sucedido

Falhas de pagamento

• Se o pagamento falhar, o sistema faz 4 tentativas de reprocessamento

• Você recebe notificações por email sobre problemas de pagamento

• Se todas as tentativas falharem, o acesso à API é suspenso

• O acesso é restaurado imediatamente após um pagamento bem-sucedido

• Faturas não pagas podem acumular encargos de juros

Suas responsabilidades de acompanhamento

Você deve manter registos precisos de:

• Registos de uso: quando o conteúdo foi confirmado e removido

• IDs dos utilizadores finais: quais utilizadores acederam a qual conteúdo

• IDs do conteúdo: quais itens de mídia foram usados

• Tipos de uso: website vs email para cada uso

• Datas: datas de início e fim para o uso no website

• URLs: URLs sem marca d’água armazenadas para uso ativo

Esses registos são essenciais para:

• Verificar as faturas mensais

• Resolver disputas de faturação

• Auditorias de conformidade pela Cathopic

• O seu próprio reporte interno

Aceder a relatórios de uso

Você pode acompanhar o uso da sua API em tempo real:

1. Vá a Definições → API

2. Veja a secção “Uso sob demanda”

3. Consulte as estatísticas do período de faturação atual:

   • Custo total acumulado até agora

   • Número de usos no website

   • Número de usos por email

4. Clique em “Ver relatório detalhado” para ver a decomposição por:

   • Utilizador final (client identifier)

   • Item de conteúdo

   • Tipo de uso

   • Intervalo de datas

   • Custos individuais

5. Exporte os relatórios em CSV para os seus registos

Negociar taxas

O preço da API é personalizado para cada cliente:

• As taxas são negociadas durante o processo de solicitação de acesso à API

• Com base no volume de uso esperado

• Com base no seu caso de uso específico e no tipo de integração

• Pode incluir descontos por volume para aplicações com alto uso

• Os limites de cobrança podem ser negociados para proporcionar custos previsíveis

Para discutir preços:

1. Visite a nossa página de suporte

2. Selecione “API access request”

3. Descreva a sua integração e o uso esperado

4. A nossa equipa fornecerá uma proposta personalizada

Compreender a licença completa

A cobrança é apenas um aspeto do contrato da API. Reveja os termos completos:

• Leia o Contrato de Licença da API na íntegra

• Entenda as restrições de uso (apenas digital, sem IA/ML, sem downloads)

• Conheça as suas obrigações de acompanhamento e reporte

• Reveja as cláusulas de propriedade intelectual e de rescisão

Para detalhes técnicos sobre a implementação:

• Veja os endpoints /confirm e /remove em api.cathopic.com/docs

• Entenda como calcular o uso para a sua integração específica

• Reveja as melhores práticas para um acompanhamento de faturação preciso

Lembre-se: o acompanhamento preciso do uso é da sua responsabilidade. Mantenha registos detalhados para garantir a cobrança correta e a conformidade com o contrato de licença.