Registro de alterações
Creator Studio e gorjetas no nível da conta
Os criadores agora podem publicar páginas de gorjetas sem criar um comerciante, aceitar pagamentos de carteira multicadeia com varredura em tempo real e gerenciar registros no Creator Studio.
O que mudou
- As páginas de gorjetas da conta permitem personalizar apresentações, exibir selos de plataformas (GitHub, X, Instagram) e compartilhar links reutilizáveis.
- As sessões de doação suportam transferências diretas e conexão de carteiras Web3 com conversão em USD em tempo real e confirmação automática na cadeia.
- O Creator Studio oferece gerenciamento de carteiras de recebimento, mensagens e recibos de doadores e análises de doações no painel da conta.
Links relacionados
Notificações da conta e recuperação de entregas
As notificações de pagamento e assinatura agora mantêm um registro rastreável durante a entrega no aplicativo e por e-mail da conta, e as novas tentativas verificam novamente se continuam válidas.
O que mudou
- Os eventos de pagamento e assinatura criam registros persistentes no aplicativo e entregas por e-mail da conta. O histórico de notificações mostra o estado da entrega enquanto a mensagem é processada.
- E-mails de conta com falha usam espera escalonada com até cinco tentativas. Antes de uma nova tentativa automática ou manual, a PolyPay verifica novamente o estado da assinatura ou do endereço monitorado e cancela notificações obsoletas em vez de enviá-las.
- As notificações do sistema não consomem a cota de notificações do monitoramento de carteiras. Os limites de entrega e as regras de estado dos endereços continuam documentados separadamente.
Links relacionados
Janela de notificações e importação de endereços no monitoramento de carteiras
O monitoramento de carteiras limita as notificações à atividade recente na blockchain, interrompe novas tentativas quando um endereço deixa de estar ativo e permite importar uma carteira de recebimento do comerciante sem pedir uma chave privada.
O que mudou
- As notificações são enviadas apenas para transações cujo horário na blockchain esteja nas últimas 72 horas. Transações mais antigas permanecem no histórico, mas não geram notificações internas, por canais externos ou por Webhook.
- Quando um endereço monitorado é desativado, excluído ou pausado por cobrança, as novas tentativas de canal em fila e os reenvios manuais são bloqueados. Mensagens já enviadas não são retiradas.
- O fluxo Adicionar endereço monitorado pode importar uma carteira de recebimento do comerciante a partir do comerciante e da carteira selecionados. A PolyPay usa o endereço público e nunca solicita a chave privada.
Links relacionados
Testes Pro por convites de canal
Novos usuários podem inserir um código de canal válido durante o cadastro ou usar um link de convite para receber três meses corridos do plano de pagamento Pro no primeiro comerciante. O teste é gratuito, não é renovado automaticamente e não isenta taxas de transação, rede ou uso.
O que mudou
- A página de cadastro aceita um código de canal PP- ou um link com ?ref=CODE, verifica a oferta antes do cadastro e mostra o canal e as condições do teste quando o código é válido.
- O cadastro por e-mail e o novo cadastro via OAuth concedem o benefício de forma atômica ao primeiro comerciante, uma vez por conta. Contas existentes não podem reivindicá-lo, e o teste de canal não pode ser combinado com recompensas de saldo por indicação.
- O teste cobre apenas a taxa de assinatura do plano de pagamento Pro. O valor é zero e a renovação automática fica desativada; após três meses corridos, o comerciante volta ao plano gratuito, a menos que escolha o fluxo pago existente.
Links relacionados
Monitoramento de carteiras e modelos de notificações
A PolyPay agora permite monitorar receitas e despesas de endereços públicos de blockchain, gerenciar notificações da carteira separadamente e configurar um Webhook independente de monitoramento.
O que mudou
- Adicione um endereço público em Monitoramento de carteiras e consulte suas receitas e despesas em uma página separada. O endereço monitorado é independente da carteira de recebimento, e a PolyPay nunca solicita uma chave privada.
- Gerencie modelos de receitas e despesas da carteira por canal e idioma em Configurações de notificações. Os endereços monitorados ativados usam os canais humanos compatíveis com o plano; somente entregas bem-sucedidas consomem a cota de notificações da conta.
- Configure um Webhook independente de monitoramento de carteiras com seu próprio escopo de eventos e endereços, assinatura HMAC-SHA256, estado de novas tentativas e payload JSON versionado. As alterações permanecem desativadas até um teste assinado ser aprovado.
JavaScript SDK 2.0 move a criação do checkout para o servidor
JavaScript SDK 2.0 remove a criação de pedidos e de links de checkout assinados no navegador. O navegador agora abre apenas URLs de Hosted Checkout criadas por um servidor confiável do comerciante.
O que mudou
- Crie o Hosted Checkout no servidor do comerciante com uma chave de API e retorne ao navegador somente o checkout_url opaco. Chaves de API, valores, URLs de retorno e materiais de assinatura não devem mais fazer parte da integração no navegador.
- PolyPayCheckout.redirect() e openModal() aceitam a URL criada pelo servidor. O redirecionamento ou o fechamento da janela não comprovam o pagamento; confirme-o por um webhook verificado ou por uma consulta autenticada do pedido no servidor.
- Foram removidos a criação de pedidos com Public Key no navegador, os Session Tokens, as APIs de pedido/status do navegador e os construtores de URLs de checkout assinadas. O suporte a x402 no servidor continua disponível em @polypay/sdk/x402.
Links relacionados
Arquivamento e restauração de comerciantes
Agora é possível arquivar um comerciante inativo sem perder o histórico e restaurá-lo depois nas configurações da conta.
O que mudou
- Arquive o comerciante atual em Gestão de comerciantes após uma confirmação. O comerciante sai do seletor normal, suas funções comerciais são interrompidas e a renovação automática da assinatura é desativada.
- O arquivamento preserva pedidos e assinaturas anteriores e não afeta o saldo da conta nem os saques.
- Veja e restaure comerciantes arquivados nas configurações da conta. Se ainda for necessária, a renovação automática da assinatura deverá ser reativada manualmente após a restauração.
Links relacionados
Documentação legível por agentes
A documentação da PolyPay agora oferece pontos de descoberta públicos e legíveis por máquina para agentes de programação e outras ferramentas automatizadas.
O que mudou
- Adicionamos o llms.txt como um mapa conciso da documentação pública.
- Adicionamos um catálogo de API compatível com a RFC 9727 para descoberta de APIs legível por máquina.
- Painéis autenticados, sessões de checkout e APIs privadas permanecem fora da superfície pública para agentes.