Programa de parceiros

Da sua ideia ao produto integrado.

Cole o prompt desta pagina no Codex, Claude ou ChatGPT, acrescente sua ideia e deixe a IA construir o projeto com os motores publicos da WordFinance. Depois de testar e publicar, envie o link para revisao e inclusao na nossa vitrine de parceiros.

Copiar o prompt completo Como aparecer no site

Motores disponiveis

O que a IA do parceiro pode integrar

WORDFINANCE PAY

USDC na Solana

O gateway cria cobranca, converte o valor em reais para USDC, abre checkout hospedado, verifica o pagamento e informa o status.

POST /api/gateway/charge
preferredMethod: "usdc"

WORDFINANCE PAY

Bitcoin Lightning

Usa o mesmo motor de cobranca e devolve invoice BOLT11, QR, sats, expiracao e consulta de status. A ativacao exige aprovacao do merchant na allowlist.

POST /api/gateway/charge
preferredMethod: "lightning"

TOKEN SPL

Pixcoin (PIXC)

PIXC ainda nao e metodo do endpoint de cobranca do gateway. A integracao e on-chain: a carteira do usuario assina e o servidor do parceiro valida mint, destino, valor e assinatura sem duplicar credito.

Mint: AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq

Arquitetura honesta: USDC e Lightning usam o WordFinance Pay hospedado. PIXC usa a rede Solana diretamente e deve ficar atras de feature flag ate o parceiro confirmar sua carteira de recebimento e homologar a verificacao on-chain.

Fluxo do gateway

Do cadastro a entrega do produto

Merchant

Registrar nome, site, carteira Solana e callback HTTPS. Guardar o merchantId somente no backend/configuracao.

Cobranca

O backend cria a charge com valor, pedido unico, metodo, retorno e webhook.

Checkout

Redirecionar para paymentUrl. O gateway mostra QR, deep link, valor e expiracao.

Confirmacao

Consultar o status no servidor e aceitar webhook assinado. Entregar apenas quando o estado for paid.

Seu ambiente

Seu .env, chaves, carteiras e segredos ficam somente com voce. Nunca envie seeds, chaves privadas ou tokens de producao para chat, frontend ou WordFinance.

Checkout seguro

Use confirmacao no servidor, webhooks assinados, idempotencia e identificadores unicos de pedido. O navegador nunca decide sozinho que um pagamento foi aprovado.

Entrega pronta

A IA deve gerar codigo, testes, documentacao, arquivo de exemplo de ambiente sem valores e um dossie de submissao para a vitrine.

Prompt integrador completo

Cole o prompt e, abaixo dele, escreva sua ideia

A IA deve descobrir a tecnologia do projeto, escolher os motores adequados, implementar, testar e preparar a submissao. Ela nao recebe segredos nem permissao para movimentar dinheiro real.

PROMPT MESTRE - PARCEIRO INTEGRADOR WORDFINANCE

Voce e meu engenheiro principal de produto, seguranca, pagamentos e deploy. Sua missao e transformar a ideia que vou escrever no fim deste prompt em um programa, site, jogo, SaaS, plugin, aplicativo ou servico funcional e integrado ao ecossistema WordFinance.

OBJETIVO FINAL
- Entender minha ideia e escolher a arquitetura adequada.
- Construir o produto completo no repositorio que eu indicar.
- Integrar somente os motores WordFinance necessarios: USDC, Bitcoin Lightning, PIXC/Solana e conexao com carteira.
- Testar localmente e em ambiente de homologacao.
- Preparar deploy sem executar movimentacao financeira real sem minha aprovacao.
- Gerar no fim um arquivo WORDFINANCE_PARTNER_SUBMISSION.md com tudo que preciso enviar para solicitar a inclusao do link do produto em https://wordfinance.org/partners.html.

ANTES DE CODIFICAR
1. Inspecione o repositorio, stack, comandos, arquivos de ambiente, testes e deploy existentes.
2. Faca no maximo as perguntas realmente bloqueantes. Quando houver uma escolha segura e reversivel, use bom julgamento e avance.
3. Apresente um plano curto com: produto, arquitetura, motores WordFinance escolhidos, modelo de dados, seguranca, testes e deploy.
4. Nao substitua nem apague trabalho existente. Preserve alteracoes alheias.

FONTES PUBLICAS OFICIAIS
- Pagina PIXC: https://wordfinance.org/pixcoin.html
- Programa de parceiros: https://wordfinance.org/partner.html
- Documentacao WordFinance Pay: https://wordfinance.org/pay-docs.html
- Gateway publico: https://wordfinance-gateway-production.up.railway.app
- Health: https://wordfinance-gateway-production.up.railway.app/api/gateway/health
- Mint publico PIXC na Solana: AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq

MOTOR 1 - WORDFINANCE PAY USDC
Use o gateway hospedado para checkout USDC nao custodial.

Cadastro do merchant (executar pelo backend ou ferramenta administrativa, nunca pelo navegador publico):
POST https://wordfinance-gateway-production.up.railway.app/api/gateway/merchant/register
Content-Type: application/json
{
  "name": "[NOME DO PRODUTO]",
  "solanaWallet": "[CARTEIRA SOLANA PUBLICA DO PARCEIRO]",
  "webhookUrl": "https://[DOMINIO]/api/payments/wordfinance/webhook",
  "platform": "[custom|woocommerce|game|saas|app]",
  "siteUrl": "https://[DOMINIO]"
}

Guarde o merchantId retornado em WORDFINANCE_MERCHANT_ID no ambiente do servidor. Nao e uma seed, mas nao deve ser editavel pelo cliente.

Criacao de cobranca USDC (sempre no backend do parceiro):
POST https://wordfinance-gateway-production.up.railway.app/api/gateway/charge
Content-Type: application/json
{
  "merchantId": "[WORDFINANCE_MERCHANT_ID]",
  "amountBRL": 99.90,
  "description": "Pedido #123",
  "orderId": "PEDIDO-UNICO-123",
  "customerEmail": "cliente@exemplo.com",
  "preferredMethod": "usdc",
  "webhookUrl": "https://[DOMINIO]/api/payments/wordfinance/webhook",
  "returnUrl": "https://[DOMINIO]/pagamento/retorno"
}

Use paymentUrl/checkoutUrl retornado para redirecionar o cliente. Persista chargeId, orderId, valor esperado, metodo, status e expiracao antes de redirecionar. Se o segredo HMAC ainda nao foi provisionado no onboarding, deixe webhookUrl vazio e use a consulta de status pelo backend como fonte de verdade.

Status:
GET  /api/gateway/charge/:chargeId
POST /api/gateway/charge/:chargeId/check

Somente o backend pode liberar produto, credito, download ou assinatura. Exija status "paid" e compare merchantId, orderId, amountBRL e metodo com o pedido persistido. Trate "pending" e "expired" explicitamente.

MOTOR 2 - BITCOIN LIGHTNING
Lightning usa o mesmo endpoint de cobranca, mudando:
"preferredMethod": "lightning"

A resposta pode incluir bolt11, sats, deepLink, paymentUrl e expiresAt. Mostre QR/BOLT11 e use o checkout hospedado quando possivel.

IMPORTANTE: Lightning so funciona para merchant aprovado na allowlist WordFinance. Implemente a interface e os testes com feature flag WORDFINANCE_LIGHTNING_ENABLED=false. Se o gateway responder que o merchant nao esta autorizado, exiba onboarding pendente e continue oferecendo USDC quando habilitado. Nunca tente acessar LNbits diretamente e nunca solicite invoice key, admin key ou saldo custodial.

MOTOR 3 - PIXCOIN (PIXC) NA SOLANA
PIXC ainda NAO e um metodo do endpoint /api/gateway/charge. Nao invente preferredMethod "pixc" e nao marque PIXC como pago usando o gateway USDC.

Para aceitar PIXC:
1. Use o mint oficial publico AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq.
2. O servidor cria um pedido persistido com orderId unico, quantidade PIXC esperada, carteira publica de destino, expiracao e status pending.
3. O cliente monta uma transferencia SPL para a carteira publica do parceiro.
4. A carteira do usuario mostra rede, token, destino e valor e pede aprovacao explicita para assinar/enviar.
5. O cliente envia ao backend apenas orderId e assinatura publica da transacao.
6. O backend consulta a Solana e valida: transacao confirmada/finalizada, mint PIXC correto, origem esperada quando vinculada, destino correto, valor igual ou maior que o pedido, horario posterior a criacao e assinatura ainda nao utilizada.
7. Grave a assinatura com restricao unica e entregue uma unica vez. Replay deve retornar o resultado anterior sem duplicar credito.
8. Use WORDFINANCE_PIXC_ENABLED=false ate homologar em devnet/valor controlado e receber aprovacao para producao.

PIXC e token utilitario. Nao escreva que e stablecoin, que vale sempre R$1, que possui resgate garantido, rendimento, lastro garantido ou listagem prometida.

MOTOR 4 - CARTEIRA E UX
- Prefira o checkout hospedado do gateway para reduzir complexidade.
- Quando integrar carteira Solana, use padroes de carteira injetada/Wallet Standard e mantenha fallback claro.
- Nunca solicite seed phrase ou chave privada.
- Toda assinatura deve mostrar ao usuario ativo, rede, destino, valor e finalidade.
- Nao esconda taxa, irreversibilidade, expiracao ou status.

WEBHOOK E IDEMPOTENCIA
- Crie POST /api/payments/wordfinance/webhook no backend.
- Leia o corpo bruto antes do parser JSON quando isso for necessario para verificar HMAC.
- Valide X-WordFinance-Signature usando o segredo fornecido durante o onboarding, somente no servidor. Antes desse provisionamento, nao aceite webhook sem assinatura: use polling server-side.
- Nao coloque segredo no frontend, Git, prompt, URL publica, log ou arquivo WORDFINANCE_PARTNER_SUBMISSION.md.
- Persista eventId com indice unico. Eventos repetidos devem responder 200 sem repetir entrega.
- O webhook acelera a confirmacao, mas o backend tambem deve conseguir consultar a charge no gateway.
- Nunca confie em status enviado pelo navegador.

VARIAVEIS DE AMBIENTE (SOMENTE NOMES E PLACEHOLDERS)
WORDFINANCE_GATEWAY_URL=https://wordfinance-gateway-production.up.railway.app
WORDFINANCE_MERCHANT_ID=
WORDFINANCE_WEBHOOK_SECRET=
WORDFINANCE_USDC_ENABLED=true
WORDFINANCE_LIGHTNING_ENABLED=false
WORDFINANCE_PIXC_ENABLED=false
WORDFINANCE_PIXC_MINT=AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq
WORDFINANCE_PIXC_RECEIVER=
SOLANA_RPC_URL=

Crie .env.example sem valores sensiveis e confirme que .env esta no .gitignore.

REQUISITOS DE SEGURANCA
- Arquitetura nao custodial: nenhuma seed/chave privada no servidor, cliente, banco ou WordFinance.
- Validar todas as entradas, limitar tamanho, aplicar rate limit e bloquear callback para localhost, IP privado ou protocolo nao HTTPS em producao.
- OrderId e chargeId devem ser imprevisiveis ou vinculados a pedido autenticado; nunca confiar em valor vindo do cliente.
- Aplicar CSRF quando houver sessao/cookie, autenticacao adequada e autorizacao por dono do pedido.
- Logs sem email completo, segredo, seed, token, invoice key ou dados financeiros desnecessarios.
- Nao usar rota administrativa de confirmacao manual.
- Nao habilitar modo demo/mark-paid em producao.
- Produtos ilegais, apostas nao autorizadas, piramide, promessa de rendimento ou servico financeiro regulado sem autorizacao nao podem usar a integracao.

ENTREGAVEIS OBRIGATORIOS
1. Produto funcional com UX desktop e mobile.
2. Modulo WordFinance isolado e documentado.
3. Banco/migracao para pedidos, eventos e assinaturas idempotentes.
4. Testes unitarios para pending, paid, expired, webhook repetido, assinatura HMAC invalida, valor divergente e replay PIXC.
5. Teste de ponta a ponta sem movimentar dinheiro real, seguido de plano de homologacao de valor minimo.
6. README com instalacao, configuracao e rollback.
7. .env.example sanitizado.
8. Health endpoint do produto.
9. Paginas publicas de Privacidade e Termos quando o produto coletar dados ou aceitar pagamento.
10. WORDFINANCE_PARTNER_SUBMISSION.md sem segredos.

CONTEUDO DE WORDFINANCE_PARTNER_SUBMISSION.md
- Nome publico do produto.
- URL HTTPS definitiva que deve aparecer na vitrine.
- Nome do responsavel/equipe e email de contato.
- Descricao curta (ate 180 caracteres) e descricao completa.
- Categoria: jogo, SaaS, loja, plugin, aplicativo, educacao ou outro.
- Metodos integrados e realmente testados: USDC, Lightning, PIXC, carteira.
- URL da logo quadrada e imagem de capa, ou caminhos dos arquivos para envio.
- URL de Privacidade, Termos e suporte.
- URL do health check, se existir.
- Evidencias de testes e data da ultima verificacao.
- Confirmacao de que nenhum segredo foi incluido.
- Texto sugerido para o card da pagina de parceiros.

CRITERIOS PARA SOLICITAR PUBLICACAO NA VITRINE
- Produto deve estar online em URL HTTPS e abrir no celular e computador.
- Integracao anunciada deve estar testada; metodos ainda pendentes devem aparecer como "em homologacao".
- Nao pode solicitar seed/chave privada nem prometer ganho, paridade ou rendimento.
- Deve ter contato, descricao verdadeira, politica de privacidade e termos quando aplicavel.
- Deve passar por revisao manual da WordFinance. A inclusao nao e automatica nem garantida.

LIMITES DE AUTONOMIA
- Pode criar e editar codigo, testes e documentacao no repositorio autorizado.
- Pode fazer verificacoes publicas e builds locais.
- Nao pode enviar pagamento real, cadastrar segredo, habilitar mainnet, publicar producao, criar merchant real ou submeter a parceria sem minha confirmacao explicita.

Ao terminar, entregue: resumo do produto, arquivos alterados, testes executados, pendencias, instrucoes de deploy e o arquivo WORDFINANCE_PARTNER_SUBMISSION.md pronto.

MINHA IDEIA COMECA ABAIXO:
[COLE AQUI SUA IDEIA, PUBLICO, FUNCOES, PLATAFORMA E MODELO DE NEGOCIO]

Ler docs do gateway

Produto pronto

Como colocar seu link na pagina de parceiros

Publique

Coloque o produto em uma URL HTTPS definitiva e teste no computador e celular.

Gere o dossie

Peça para sua IA finalizar o arquivo WORDFINANCE_PARTNER_SUBMISSION.md.

Envie

Mande o link, descricao, logo, metodos testados, Privacidade, Termos e contato. Nunca envie .env ou segredo.

Revisao e vitrine

A WordFinance confere seguranca e funcionamento. Aprovado, o card e o link entram em partners.html.

Enviar produto para revisao Ver a vitrine atual

A revisao e manual para proteger usuarios e parceiros. Aprovacao e destaque nao sao automaticos. Uma doacao limitada de PIXC pode ser avaliada pelo criador para integracoes verificadas, sem promessa de valor ou remuneracao.