solvopay.FINIX · SANDBOX EXCLUSIVO

LABORATÓRIO DE CERTIFICAÇÃO

Integração real.
Dinheiro fictício.

Ambiente dedicado para o roteiro técnico da Finix. Sem conexão com bancos, credenciais, contas ou ledger da produção SolvoPay.

Estado do ambiente

Consultando apenas a configuração local do serviço…

Sem criação de senha, chave ou sessão própria: a área operacional exige sua identidade Cloudflare Access, verificada no servidor.

Configuração segura pelo proprietário

Não cole credenciais nesta página nem no chat. Não existe endpoint de cadastro ou leitura de segredos neste módulo.

  1. Cloudflare Dashboard → Workers & Pages → solvopay-finix-sandbox → Settings → Variables and Secrets. Cadastrar como Secret: FINIX_SANDBOX_API_USERNAME e FINIX_SANDBOX_API_PASSWORD, usando uma credencial sandbox existente. A senha não volta em GET, HTML ou logs.
  2. Para autenticação sem senha/chave própria: neste projeto Pages → Settings → Enable access policy → Manage. No aplicativo Access criado para previews, editar o hostname removendo o wildcard para proteger solvopay-finix-sandbox.pages.dev; limitar o caminho a /api/operator/* e a política Allow somente ao seu e-mail via identidade/OTP. Não criar service token/API key. Se desejado, habilitar novamente a política de previews separada. Copiar Team domain e Application Audience (AUD) para as variáveis CF_ACCESS_TEAM_DOMAIN (sem https), CF_ACCESS_AUD e FINIX_SANDBOX_OPERATOR_EMAILS deste sandbox. Essa configuração de acesso não foi criada nesta entrega; depende de ação explícita do proprietário. O backend exige JWT assinado mesmo em URLs alternativas de deploy.
  3. Salvar/reimplantar somente este projeto sandbox. Deixar FINIX_SANDBOX_TOKENIZATION_ENABLED, FINIX_SANDBOX_PAYMENTS_ENABLED e FINIX_SANDBOX_WEBHOOK_ENABLED em false até a próxima autorização. Credenciais presentes não habilitam transações.

Endpoint de webhook preparado: /api/finix/sandbox/webhook. Ainda não cadastrado na Finix. Configuração de assinatura/autenticação é uma etapa separada e não é necessária para consultar transferências/disputas pela API.

Roteiro de certificação

  1. Trigger successful transaction.
  2. Trigger failed transaction com fixtures oficiais.
  3. Enviar idempotency_id UUID no JSON da API e preservar controle durável.
  4. Comprovar uso de Finix.PaymentForm V2 real.
  5. Trigger Dispute com amount=888888, exclusivamente em sandbox; consultar a disputa até ela ser observada.

Fixtures oficiais Finix · Tokenization Forms V2