API de pagamentos VwtlProxy

Documentação dos pedidos e da confirmação de recebimento direto em carteira. As rotas são relativas à origem do site VwtlProxy.

Sessão de pagamento

O pagamento funciona sem cadastro e sem login no ChatGPT. A consulta GET /api/payments/config inicia automaticamente uma sessão privada de pagamentos no navegador quando necessário. O cookie é exclusivo do host, usa HttpOnly, Path=/, SameSite=Strict e expira no navegador após 30 dias. Em HTTPS ele também usa Secure e o prefixo __Host-; o preview HTTP local usa um nome sem prefixo e sem Secure.

O navegador envia o cookie nas requisições à mesma origem. O servidor autoriza somente os pedidos e o saldo dessa sessão. O segredo de sessão tem 32 bytes aleatórios; o banco armazena apenas seu identificador derivado por hash e não o segredo. O e-mail de contato não autentica uma pessoa nem libera pedidos de outra sessão.

Se a hospedagem já fornecer uma identidade autenticada legada do ChatGPT, ela tem prioridade para preservar o histórico dessa conta. Os pedidos antigos não são migrados nem expostos à sessão anônima. Visitantes não precisam dessa identidade para comprar ou recarregar.

Os pedidos POST usam Content-Type: application/json e a origem é validada pelo servidor. O formulário visual de cadastro não cria conta, senha de acesso ou chave de API. A sessão de pagamentos é criada pela configuração, independentemente desse formulário.

Rotas disponíveis

Método	Rota	Recurso
GET	`/api/payments/config`	Métodos de pagamento, redes, disponibilidade e taxa.
POST	`/api/payments/invoices`	Cria uma cobrança com preço calculado no servidor.
GET	`/api/payments/invoices`	Retorna até 20 pedidos do usuário e o saldo de recargas confirmadas.
GET	`/api/payments/invoices/{id}`	Consulta um pedido próprio e verifica uma transação registrada.
POST	`/api/payments/invoices/{id}/transaction`	Registra o hash público da transação para verificação.

E-mail de contato e ativação

O campo contactEmail é obrigatório em toda nova cobrança de compra ou recarga. A tela solicita esse e-mail antes de criar a cobrança e exibir o QR code. Informe o endereço para contato e envio dos dados de ativação do pedido.

O servidor valida o formato, rejeita caracteres de controle e quebras de linha, remove espaços nas extremidades e converte o endereço para minúsculas. O endereço normalizado tem no máximo 254 caracteres. E-mail ausente ou malformado retorna HTTP 422 com o código invalid_contact_email, antes de gerar as instruções da cobrança.

O e-mail normalizado fica no pedido, no histórico e no snapshot da fila de preparação. Ele também participa da idempotência: repetir o mesmo pedido com a mesma chave e o mesmo e-mail normalizado recupera a cobrança original; trocar o e-mail mantendo a chave gera conflito HTTP 409.

Esse contato não autentica o cliente nem concede acesso a pedidos. A autorização usa a sessão privada de pagamentos do navegador ou a identidade legada já disponível na hospedagem. A implementação não envia e-mail automaticamente; o contato e a ativação dependem do atendimento da equipe. Pedidos antigos sem contactEmail permanecem disponíveis para consulta e verificação.

Criar uma cobrança de compra

Corpo JSON de exemplo. Gere uma nova chave de idempotência para cada pedido; ela deve ter de 32 a 128 caracteres usando letras, números, hífen ou sublinhado. Repetir a mesma chave com os mesmos dados recupera a cobrança original. Alterar o pedido mantendo a chave retorna conflito.

{
  "kind": "purchase",
  "planId": "2gb",
  "productType": "dynamic",
  "quantity": 1,
  "methodId": "eth-ethereum",
  "idempotencyKey": "vwtlproxy-example-invoice-00000001",
  "contactEmail": "customer+activation@example.test"
}

O servidor recalcula os valores a partir do plano, produto e quantidade. Não aceita endereço de recebimento, configuração de rede ou preço arbitrário enviados pelo cliente.

Projeção dos campos monetários da resposta de 2 GB (o pedido real também inclui ID, prazo, moeda, rede, endereço, cotação e instruções de transferência):

{
  "kind": "purchase",
  "planId": "2gb",
  "productType": "dynamic",
  "quantity": 1,
  "subtotalCents": 2878,
  "feeBasisPoints": 150,
  "feeCents": 43,
  "totalCents": 2921,
  "currency": "USD",
  "status": "awaiting_payment",
  "contactEmail": "customer+activation@example.test"
}

Recarga

A recarga mínima é US$30,00. O formulário inicia em US$50,00, com taxa de US$0,75 e total de US$50,75. O crédito confirmado corresponde ao subtotal de US$50,00; a taxa não compõe o saldo.

{
  "kind": "recharge",
  "amountCents": 5000,
  "methodId": "eth-ethereum",
  "idempotencyKey": "vwtlproxy-example-recharge-000001",
  "contactEmail": "customer+activation@example.test"
}

Confirmar uma transação

Consulte os métodos disponíveis em /api/payments/config.
Crie a cobrança com um método disponível e uma chave de idempotência própria.
Confira moeda, rede, endereço completo, quantidade exata, total e prazo.
Nos métodos automáticos, use a transactionRequest retornada pelo servidor no botão Pagar com MetaMask. Ela inclui a referência única que vincula a transferência ao pedido.
Após a carteira retornar o hash, registre {"txid":"hash retornado pela carteira"} na rota de transação.
Consulte o pedido para acompanhar as confirmações. Mostre sucesso somente quando status estiver paid.

Uma transferência realizada copiando somente o endereço ou QR pode não conter a referência e exige conferência pelo suporte. Bitcoin, Solana, Tron e Stellar usam conferência manual. Informar um hash sozinho não comprova recebimento nem muda o pedido para pago.

A cotação vale 10 minutos. O servidor verifica a rede, o destinatário, o valor, a referência, a execução da transação, o período válido e as confirmações exigidas. Uma transação verificada não pode pagar dois pedidos. Não existe callback público de confirmação de pagamento; o acompanhamento ocorre pela consulta do pedido.

Estados e erros

Estado	Significado
`awaiting_payment`	Cobrança criada, aguardando uma transação.
`check`	Transação registrada, aguardando verificação.
`confirm_check`	Transação localizada, aguardando confirmações da rede.
`paid`	Recebimento validado na blockchain.
`manual_review`	Método com conferência pelo suporte.
`needs_review`	Dados da transação não atendem à cobrança; análise necessária.
`expired`	Prazo da cotação encerrado. Gere outra cobrança antes de enviar.

As respostas de erro seguem {"error":{"code":"código","message":"mensagem"}}. Sessão ausente ou inválida: 401 (session_required). Origem recusada: 403. Pedido inexistente ou de outra sessão/conta: 404. Conflito de idempotência ou transação já usada: 409. Corpo acima de 8 KiB: 413. Formato de conteúdo inadequado: 415. Dados inválidos ou preço divergente: 422. Limite temporário: 429. Cotação, rede ou serviço indisponível: 503.

Preços oficiais e cálculo

Todos os valores em USD usam centavos inteiros. A taxa de conversão é de 1,5% sobre o subtotal, com arredondamento para centavos. A taxa da blockchain é separada e paga pelo remetente. A referência de preço é US$15,99 por GB; o plano de 2 GB aplica desconto de 10% e usa US$14,39 por GB. Dinâmico e móvel têm a mesma tabela. 1 TB = 1.000 GB.

Plano	Tarifa por GB	Subtotal	Taxa 1,5%	Total a pagar
2 GB	US$14,39	US$28,78	US$0,43	US$29,21
50 GB	US$11,99	US$599,50	US$8,99	US$608,49
100 GB	US$11,99	US$1.199,00	US$17,99	US$1.216,99
1 TB	US$10,99	US$10.990,00	US$164,85	US$11.154,85
2 TB	US$9,99	US$19.980,00	US$299,70	US$20.279,70
5 TB	US$8,89	US$44.450,00	US$666,75	US$45.116,75

Nos proxies estáticos e compartilhados, o subtotal usa dias × tarifa por IP/dia × número de IPs do catálogo. Consulte Preços e cobrança para esses planos.

Disponibilidade dos recursos

Esta documentação descreve os recursos de pagamento implementados na VwtlProxy. A API de fornecimento, extração, renovação e entrega de proxies ainda depende de integração com o fornecedor e não está disponível nestas rotas. A confirmação do pagamento coloca uma compra na fila de preparação; não produz credenciais de proxy automaticamente.

Pagamentos de compra confirmados exibem o prazo de 1 a 24 horas para disponibilização dos proxies. Como nossos servidores são chineses, pode ocorrer demora na entrega e na resposta do suporte. Dúvidas: support@vwtlproxy.com.