Depósitos e saldo
Depósitos CCPayment e saldo da conta Solucaptcha, em USD.
Todas as suas chaves compartilham o saldo disponível: depósitos confirmados menos consumos registrados pelo solver. balanceCents indica os depósitos; balanceMicrocents indica o saldo disponível para API (dividir por 100000 para USD). A cobrança atual ocorre na criação; estorno por falha ainda não está implementado. Saques não estão disponíveis.
Como depositar
- Entre na conta com email verificado e abra Créditos.
- Escolha de US$5 a US$1.000. O checkout vence após 1 hora.
- Na CCPayment, escolha a criptomoeda e a rede corretas e siga as instruções do checkout.
- Aguarde a confirmação. Voltar ao site ou atualizar a página não comprova pagamento.
O crédito automático é o valor em USD solicitado, sem bônus por excedentes. A taxa de processamento CCPayment é custo do site; taxas da carteira/rede são pagas separadamente pelo cliente. Não envie pela rede errada nem reutilize checkout vencido.
Estados e confirmação
| status | Significado |
|---|---|
creating | Criando checkout |
pending | Aguardando pagamento |
processing | Aguardando confirmação |
partial | Valor recebido ainda insuficiente |
expired | Checkout vencido |
review | Pagamento tardio, risco ou divergência: suporte necessário |
credited | Crédito confirmado uma única vez |
O servidor verifica a assinatura do webhook e consulta novamente o pedido na CCPayment. Só transações confirmadas, sem risco, com moeda/preço corretos, recebidas no prazo e total suficiente creditam automaticamente. Valores parciais aguardam complementação; excedentes, atrasos e divergências exigem análise pelo suporte.
O histórico é persistido e a conferência continua sem o navegador aberto, até 7 dias após o vencimento. A interface consulta a cada 30 segundos; atualização manual por pedido é limitada a cada 15 segundos.
Rotas do portal — sessão da conta
Base: https://solucaptcha.com. Exigem sessão com email verificado, não clientKey. POSTs da conta exigem JSON e origem válida. O webhook é uma rota separada exclusiva para notificações assinadas do provedor.
| Endpoint | Contrato |
|---|---|
GET /api/portal/payments | enabled, currency, balanceCents, minimumCents, maximumCents, orders (30) |
POST /api/portal/payments/create | {"amount":"10.00","requestId":"UUID","locale":"pt-br"} |
POST /api/portal/payments/orders/:id/refresh | {} |
POST /api/portal/payments/webhook | CCPayment: assinatura obrigatória, sem sessão |
{
"enabled": true,
"currency": "USD",
"balanceCents": 0,
"balanceMicrocents": 0,
"apiEnabled": true,
"minimumCents": 500,
"maximumCents": 100000,
"orders": []
}Exemplo ilustrativo. balanceCents é inteiro: 1000 corresponde a US$10,00 em depósitos. balanceMicrocents informa o saldo disponível para a API: divida por 100000 para USD. A criação retorna id, amountCents, status, checkoutUrl, canPay e timestamps em milissegundos. Reutilize o mesmo requestId UUID ao repetir a mesma tentativa com o mesmo valor; nunca gere crédito pelo navegador.
Erros e segurança
HTTP 400: INVALID_INPUT / PAYMENT_AMOUNT_INVALID; 401: UNAUTHENTICATED; 403: FORBIDDEN; 404: NOT_FOUND; 429: RATE_LIMITED; 503: PAYMENTS_UNAVAILABLE / PAYMENT_PROVIDER_UNAVAILABLE.
Essas rotas usam códigos HTTP e code, não errorId do solver. Assinatura inválida no webhook retorna 401 INVALID_SIGNATURE. Notificação processada retorna texto Success; ativação assinada ActivateWebhookURL retorna JSON {"msg":"Success"}. Nenhum segredo CCPayment deve aparecer no navegador, exemplos ou tickets.
Verificação: checkout não pago, teste oficial do webhook e testes automatizados aprovados. Ainda não foi realizado depósito real para validar liquidação financeira ponta a ponta.
Revisado em 11/10/2026 com base em docs/especificacao-api.md. Disponibilidade do site e validação dos motores são estados distintos.