> ## Documentation Index > Fetch the complete documentation index at: https://docs.ephra.io/llms.txt > Use this file to discover all available pages before exploring further. # Novidades > O que mudou no painel, no checkout e na API da Ephra, da mais recente para a mais antiga. ## Outubro de 2026 ### Pixels do afiliado e link por plano na API 20 de outubro de 2026 O afiliado lê e grava os pixels que o link dele dispara, como na tela de configurações da afiliação. * `GET /v1/affiliations/{affiliationId}/pixels` lista os pixels. * `PUT /v1/affiliations/{affiliationId}/pixels` grava o conjunto completo: o que fica de fora é removido. Em `GET /v1/products/{productId}/links`, cada link agora traz `offerId`, `frequency` e `url`. Em assinatura, cada plano vem com o seu link. [Ver na referência](https://docs.ephra.io/api-reference/introducao.md) ### Respostas do quiz no webhook de reembolso 20 de outubro de 2026 Quando o comprador responde o quiz antes de pedir o reembolso, o `refund_requested` já chega com as respostas. ```json theme={"system"} { "refundQuiz": { "attemptId": "cmh1qz0a0001ab12cd34ef56", "completedAt": "2026-10-20T13:02:40.000Z", "answers": [ { "questionId": "cmh1qq0a0001ab12cd34ef56", "question": "O que fez você pedir o reembolso?", "answer": "Não tive tempo" } ] } } ``` [Ver no webhook](https://docs.ephra.io/webhooks/eventos/transacoes.md) ### Área de membros em Minhas compras 20 de outubro de 2026 O comprador de um curso da área de membros nativa entra em **Minhas compras** e clica em **Acessar área de membros**. Se ainda não criou senha, cai direto na tela de criar senha. O link de Minhas compras já vai em todo webhook de venda, em `customer.purchasesUrl`, e no `release_access`. ### Afiliado e comissão no webhook 20 de outubro de 2026 Venda que veio de afiliado chega no webhook com quem vendeu e quanto ganhou. ```json theme={"system"} { "affiliate": { "affiliationId": "cmh1aff0a0001ab12cd34ef56", "name": "Ana Souza", "commissionPercentage": 30, "commissionAmount": 5970 } } ``` Venda sem afiliado não traz o bloco. [Ver no webhook](https://docs.ephra.io/webhooks/eventos/transacoes.md) ### Gestão pelo seller na API 20 de outubro de 2026 A API do vendedor ganhou 25 operações novas, e o MCP também. * Comissão negociada por afiliado. * Configuração do reembolso e perguntas do quiz. * Comprovante de reembolso. * Apple Pay por produto. * Adicional de juros por parcela. * Pastas de produtos. * Vendas por estado no resumo do painel. * Duplicar e mover aulas, capa do módulo e logo do curso na área de membros. ```bash theme={"system"} curl -s "https://api.ephra.io/v1/product-folders" \ -H "Authorization: Bearer $TOKEN" ``` ### Venda com produto, oferta e partes do pagamento na API 20 de outubro de 2026 A consulta de venda passa a trazer o produto, a oferta, os order bumps e, no Cartão + Pix e nos dois cartões, as partes do pagamento, no mesmo formato do webhook. ```json theme={"system"} { "product": { "id": "cmh1prd0a0001ab12cd34ef56", "name": "Curso de Tráfego" }, "offer": { "id": 4821, "name": "Plano anual" }, "orderBumps": [] } ``` [Referência de vendas](https://docs.ephra.io/api-reference/transacoes-consultar.md) ### Apple Pay no checkout 16 de outubro de 2026 O comprador paga com Apple Pay em um toque, no iPhone e no Mac. Está ligado para todas as empresas ativas. * Taxa própria na aba **Taxas** do Financeiro. * Filtros Apple Pay e Cartão digitado em **Vendas**. * Carteira em coluna própria no CSV de vendas. **Na API e no webhook**, a venda continua `credit_card` e ganha o bloco `wallet`: ```json theme={"system"} { "wallet": { "type": "apple_pay", "network": "Visa" } } ``` ### Painel novo 16 de outubro de 2026 O painel compara o período escolhido com o anterior. * Saldo disponível. * Chargebacks do período. * Vendas por estado. **Na API**, o resumo do painel, com os chargebacks, está em `GET /v1/dashboard/summary`. As vendas por estado vêm no campo `salesByState`, no mesmo resumo. ### Tela de Assinaturas nova 16 de outubro de 2026 A tela de **Assinaturas** mostra o faturamento recorrente (MRR) e marca as assinaturas em atraso. **Na API**, o MRR vem no campo `mrr` de `GET /v1/dashboard/summary`. ### Nova área de membros 15 de outubro de 2026 Uma área de membros própria da Ephra. O comprador recebe o acesso sozinho quando a venda é aprovada. * Cursos com módulos e aulas em vídeo. * Materiais, comentários e avaliação nas aulas. * Certificado de conclusão. * Edição do curso por cima da visão do aluno. * Liberação agendada de módulos e aulas. * Cor de destaque da área. **Na API**, cursos, módulos, aulas e matrículas têm rotas próprias: ```bash theme={"system"} curl -s "https://api.ephra.io/v1/member-courses?page=1&pageSize=10" \ -H "Authorization: Bearer $TOKEN" ``` [Guia da área de membros](https://docs.ephra.io/guias/area-de-membros.md) ### Mais dados na venda pela API 15 de outubro de 2026 A consulta de venda passou a trazer a carteira, o prazo de reembolso, as parcelas e os juros repassados ao comprador. ```json theme={"system"} { "id": "clxabc123def456", "paymentMethod": "credit_card", "installments": 3, "interestPassthroughAmount": 1490, "refundPeriodDays": 7, "refundDeadline": "2026-10-22T23:59:59-03:00", "wallet": { "type": "apple_pay", "network": "Visa" } } ``` [Referência de vendas](https://docs.ephra.io/api-reference/transacoes-consultar.md) ### Parcela pré-definida descontinuada 15 de outubro de 2026 O checkout sempre abre na maior parcela. Os campos `preDefinedInstallment*` foram descontinuados e não têm mais efeito. ### Boleto descontinuado 15 de outubro de 2026 O boleto não gera mais cobrança nova. Ele aparece só em vendas antigas. ### Adicional de juros por parcela 14 de outubro de 2026 Você define um adicional sobre os juros de cada parcela, de 2x a 12x, na aba **Taxas** do Financeiro. **No webhook**, a parte que fica com você vem separada: ```json theme={"system"} { "transaction": { "baseAmount": 100000, "installmentInterestAmount": 12000, "installmentOperatorAmount": 9000, "installmentInterestSellerAmount": 3000 } } ``` [Venda parcelada com juros](https://docs.ephra.io/webhooks/eventos/transacoes.md#venda-parcelada-com-juros) ### Minhas compras 9 de outubro de 2026 O comprador entra com um código no e-mail e acessa tudo o que comprou, num lugar só. **No webhook**, o link vem em toda venda, pronto para o seu e-mail de boas-vindas: ```json theme={"system"} { "customer": { "purchasesUrl": "https://app.ephra.io/compras" } } ``` ### Oferta gratuita 8 de outubro de 2026 Uma oferta de R\$ 0 gera venda aprovada na hora, sem cartão e com todos os webhooks. Venda gratuita não tem reembolso e fica fora das métricas. Serve para aula grátis, isca digital e para testar a sua integração de ponta a ponta. **No webhook**, a venda gratuita chega como `transaction_paid`, com valor zero e marcada em `sale.isFree`: ```json theme={"system"} { "event": "transaction_paid", "transaction": { "amount": 0, "status": "paid" }, "sale": { "isFree": true } } ``` **Na API**, a oferta gratuita é criada com `isFree: true` em `POST /v1/products/{productId}/offers`, e o webhook marca a venda com `sale.isFree`. ### Planos parcelados 7 de outubro de 2026 Planos bimestrais, trimestrais, semestrais e anuais podem ser parcelados no cartão. **Na API**, o plano é criado em `POST /v1/products/{productId}/offer-plans`, com a frequência em `frequency`: ```json theme={"system"} { "title": "Mentoria de Copywriting Trimestral", "price": 49900, "frequency": "quarterly", "renewalType": "until_cancelled" } ``` **No webhook**, a venda traz a frequência do plano em `sale.subscriptionInterval`. ### Link de venda por plano 7 de outubro de 2026 Cada plano de assinatura ganha o seu próprio link de venda, para você divulgar o anual separado do mensal. Por enquanto, o link de cada plano fica só no painel. ## Setembro de 2026 ### Quiz de reembolso 25 de setembro de 2026 Antes de pedir o reembolso, o comprador responde um quiz que você monta por produto. No fim, ele pode receber uma contraoferta, como acesso a outro produto. Quando o estorno conclui, a Ephra emite o comprovante. **Na API**, as respostas ficam disponíveis para você analisar: ```bash theme={"system"} curl -s "https://api.ephra.io/v1/refund-quiz-attempts?page=1&pageSize=10" \ -H "Authorization: Bearer $TOKEN" ``` ### Empresa Pessoa Física 25 de setembro de 2026 Agora dá para vender como Pessoa Física, com CPF. ### Recuperação da senha de transação 25 de setembro de 2026 Quem esquecer a senha de transação recupera por um código enviado no e-mail. ### Afiliados 24 de setembro de 2026 O programa de afiliados ganhou gestão mais fina. * Comissão negociada por afiliado. * Pausar e reativar um afiliado. * Aprovar ou recusar em massa. * Busca por nome, e-mail ou produto. * Pixels próprios para cada afiliado. * E-mail para o produtor a cada nova solicitação. **Na API**, pausar e reativar é a mesma rota que aprova e recusa, `PATCH /v1/affiliates/{affiliateId}`: ```json theme={"system"} { "status": "inactive" } ``` Use `approved` para reativar. A comissão negociada é definida em `PUT /v1/affiliates/{affiliateId}/commission`. Os pixels do afiliado ficam, por enquanto, só no painel. ### Pix em assinatura 24 de setembro de 2026 Assinaturas aceitam Pix. A cada ciclo, o comprador paga a renovação pelo checkout. **No webhook**, a renovação paga chega como `transaction_paid`, com a frequência do plano: ```json theme={"system"} { "event": "transaction_paid", "transaction": { "status": "paid" }, "sale": { "type": "recurring", "subscriptionInterval": "monthly" } } ``` Pela API, `POST /v1/subscriptions` cria assinatura só no cartão por enquanto. ### Cartão + Pix 23 de setembro de 2026 O comprador divide o pagamento entre cartão e Pix. Você liga por produto. **No webhook**, a venda chega com as duas partes: ```json theme={"system"} { "split": { "mode": "card-pix", "parts": [ { "sequence": 1, "paymentMethod": "credit_card", "amount": 15000, "installments": 3, "status": "paid" }, { "sequence": 2, "paymentMethod": "pix", "amount": 5000, "installments": null, "status": "paid" } ] } } ``` [Venda dividida em dois meios](https://docs.ephra.io/webhooks/eventos/transacoes.md#venda-dividida-em-dois-meios) ### Dois cartões 23 de setembro de 2026 O comprador divide o pagamento entre dois cartões. Você liga por produto, e o webhook traz o bloco `split` com `"mode": "double-card"`. ### API do vendedor 12 de setembro de 2026 Mais de 140 operações para fazer pela API o que o painel faz: produtos, ofertas, checkouts, cupons, afiliados, reembolsos, financeiro e webhooks. ```bash theme={"system"} curl -s "https://api.ephra.io/v1/products?page=1&pageSize=10" \ -H "Authorization: Bearer $TOKEN" ``` [Início rápido](https://docs.ephra.io/comece-aqui/inicio-rapido.md) ### Servidor MCP 12 de setembro de 2026 A API do vendedor também vira um servidor MCP, para um agente de IA operar a sua conta em linguagem natural. [Conectar o MCP](https://docs.ephra.io/guias/mcp.md) ## Agosto de 2026 ### Cadastro pelo CNPJ 28 de agosto de 2026 Informe o CNPJ e o cadastro da empresa se preenche sozinho, com o cartão CNPJ emitido automaticamente. ### Valor mínimo por venda 25 de agosto de 2026 Preço base e parcela precisam ser de pelo menos R\$ 5,00. A regra vale também na API: criar ou editar oferta com preço ou parcela abaixo de R\$ 5,00 é recusado. ### Oferta e order bumps no webhook 14 de agosto de 2026 O payload de venda passou a trazer o nome da oferta e dos order bumps. ```json theme={"system"} { "sale": { "mainOfferId": 4821, "mainOfferName": "Plano anual", "orderBumps": [ { "id": "clxbump123", "offerId": 4822, "name": "Planilha bônus" } ] } } ``` [Eventos de venda](https://docs.ephra.io/webhooks/eventos/transacoes.md) ### TikTok Events API 13 de agosto de 2026 Pixel de servidor para o TikTok. A conversão chega mesmo quando o comprador usa bloqueador de anúncio. **Na API**, o pixel é cadastrado em `POST /v1/pixels`. Os provedores aceitos saem de `GET /v1/pixel-providers`. ### Taboola 13 de agosto de 2026 Pixel de servidor para o Taboola, com a mesma entrega de conversão pelo servidor. **Na API**, o pixel é cadastrado em `POST /v1/pixels`. Os provedores aceitos saem de `GET /v1/pixel-providers`. ### Link de acesso no release\_access 12 de agosto de 2026 O evento `release_access` traz o link que leva o comprador direto para dentro da área de membros. ```json theme={"system"} { "access": { "magicLink": "https://..." } } ``` [Liberação de acesso](https://docs.ephra.io/webhooks/eventos/acesso.md) ### Notas fiscais pela Spedy 11 de agosto de 2026 Conecte a Spedy e a nota fiscal sai sozinha a cada venda aprovada. **Na API**, a conexão com a Spedy fica em `/v1/integrations/spedy`: ```bash theme={"system"} curl -s "https://api.ephra.io/v1/integrations/spedy" \ -H "Authorization: Bearer $TOKEN" ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.