Referência de integração VwtlProxy

VwtlProxy — referência de integração de pagamentos

Escopo real: cobranças, histórico de pedidos, registro de hash público e verificação de recebimento.
Base URL: a própria origem do site; use rotas relativas.
Sessão: pagamentos funcionam sem cadastro ou login no ChatGPT. GET /api/payments/config inicia uma sessão privada de pagamentos no navegador quando necessário.
Cookie host-only, Path=/, HttpOnly, SameSite=Strict; expiração no navegador de 30 dias. HTTPS usa __Host-vwtl_payment_session e Secure. Preview HTTP usa vwtl_payment_session sem Secure.
O cookie é enviado automaticamente em fetch same-origin. Cada sessão consulta somente seus pedidos e seu saldo.
O segredo tem 32 bytes aleatórios; o banco usa um identificador guest derivado por SHA-256 e não salva o token em texto claro. Token e identificador de sessão não são retornados nos pedidos.
E-mail de contato não é autenticação. Identidade ChatGPT já fornecida pela hospedagem tem prioridade somente para compatibilidade com o histórico da conta; não é obrigatória para visitantes. Pedidos antigos não são migrados nem expostos a sessões anônimas.
O cadastro visual da VwtlProxy não cria conta nem chave de API. A configuração inicia a sessão de pagamentos independentemente do formulário.
POST: Content-Type application/json; mesma origem do site; corpo até 8192 bytes.

GET /api/payments/config
Métodos de pagamento, endereços públicos, redes, disponibilidade e feeBasisPoints=499. Emite Set-Cookie para iniciar uma sessão anônima quando não há sessão válida ou identidade legada.
POST /api/payments/invoices
Compra: kind=purchase, planId, productType, quantity, methodId, idempotencyKey, contactEmail (obrigatório).
Recarga: kind=recharge, amountCents, methodId, idempotencyKey, contactEmail (obrigatório).
A chave de idempotência tem 32–128 caracteres: letras, números, hífen e sublinhado.
contactEmail é o e-mail de contato e ativação, obrigatório antes de criar a cobrança e exibir o QR.
O servidor remove espaços nas extremidades, converte para minúsculas e valida o formato; o endereço normalizado tem limite de 254 caracteres e não aceita controles/quebras de linha.
Sem e-mail válido, a criação retorna HTTP 422, código invalid_contact_email, sem instruções de pagamento.
O e-mail normalizado participa do fingerprint de idempotência e fica no snapshot do pedido e da fila de preparação. A mesma chave com outro e-mail retorna conflito 409.
Não existe envio automático de e-mail nesta implementação; contato e ativação dependem do atendimento da equipe.
Pedidos antigos sem contactEmail continuam legíveis e verificáveis.
O servidor calcula preços pelo catálogo; não aceita endereço ou rede definidos pelo cliente.
GET /api/payments/invoices
Retorna orders (até 20 pedidos próprios) e balanceCents das recargas confirmadas.
GET /api/payments/invoices/{id}
Consulta um pedido próprio e verifica a transação registrada quando aplicável.
POST /api/payments/invoices/{id}/transaction
Corpo: {"txid":"hash público retornado pela carteira"}.
Método automático EVM exige hash hexadecimal de 32 bytes com prefixo 0x.

USD em centavos inteiros; 1 TB=1000 GB; referência US$15,99/GB.
2 GB: unitCents=1439, referência do pacote=3198, subtotalCents=2878, feeCents=144, totalCents=3022; desconto 10%.
50 GB: unitCents=1199, subtotalCents=59950, feeCents=2992, totalCents=62942.
100 GB: US$11,99/GB; 1 TB: US$10,99/GB; 2 TB: US$9,99/GB; 5 TB: US$8,89/GB.
Dinâmico e móvel usam a mesma tabela. Estáticos e compartilhados: dias × tarifa por IP/dia × quantidade de IPs do catálogo.
Taxa de conversão: 4,99% do subtotal, arredondada para centavos. Taxa de rede separada, paga pelo remetente.
Recarga mínima: US$30,00. Exemplo de recarga: subtotal 5000, taxa 250, total 5250; crédito 5000.

Cotação válida por 10 minutos. amountCrypto/amountAtomic vêm da cotação atual; não fixe quantidades de cripto em documentação.
Nos métodos automáticos, use transactionRequest retornada, preservando chainId, to, value e data. Ela inclui referenceHex e vincula a transferência ao pedido.
Use Pagar com MetaMask para o envio e registre o hash retornado. Consultas acompanham as confirmações da blockchain; não há callback público de pagamento.
Apenas status=paid confirma recebimento. A validação verifica rede, destinatário, valor, referência, execução, prazo e confirmações exigidas.
Endereço ou QR sem referência não garantem confirmação automática. Bitcoin, Solana, Tron e Stellar usam conferência manual pelo suporte.
Estados: awaiting_payment, check, confirm_check, paid, manual_review, needs_review, expired.
Erro: {"error":{"code":"código","message":"mensagem"}}.
HTTP: 401 sem sessão válida (session_required), 403 origem inválida, 404 pedido não encontrado, 409 conflito, 413 corpo grande, 415 conteúdo inadequado, 422 dados inválidos, 429 limite temporário, 503 indisponibilidade.

Compra paga: fila de preparação; prazo informado de entrega de proxies de 1 a 24 horas após a confirmação.
Recarga paga: subtotal creditado no saldo.
A API de fornecimento, extração, renovação e entrega de proxies está pendente de integração com fornecedor. Estas rotas não geram credenciais de proxy.
Como nossos servidores são chineses, pode ocorrer demora na entrega e na resposta do suporte.
Suporte: support@vwtlproxy.com.
Documentação: /docs/server/OpenAPI.html; guia: /docs/server/api-guide.html; contrato: /docs/server/openapi-spec.html.