O que a Nash entrega
A Nash é o plano de controle para criar e operar gateways Pix white-label. O painel administra marca, domínio, lojistas, catálogo, checkout, transações, webhooks e operação. Cada gateway publicado é um tenant independente e não compartilha identidade, sessão ou dados com o painel Nash.
- O dinheiro é liquidado pela adquirente conectada; a Nash não funciona como carteira custodial.
- O endereço padrão usa um domínio de gateways isolado de nash.lat; o Pro também permite domínio próprio verificado.
- O template público e o portal do lojista usam dados persistidos, sem conteúdo financeiro fictício.
Conceitos principais
Uma conta verificada recebe um workspace. Dentro dele, o operador cria gateways e escolhe explicitamente o gateway ativo no painel.
- Workspace: organização e fronteira superior de acesso.
- Gateway: operação white-label com marca, domínio, plano e adquirentes próprios.
- Lojista: vendedor isolado, sujeito a e-mail verificado, KYC e provisionamento no provedor.
- Link de checkout: oferta persistida em BRL, com valor armazenado em centavos.
- Transação: tentativa de pagamento conciliada com a adquirente e identificada pelo tenant.
Caminho de ativação
O cadastro não cria um gateway automaticamente. A sequência operacional evita publicar uma estrutura sem responsável, adquirente ou identidade definida.
- Verifique o e-mail e conclua a criação do workspace.
- Crie o gateway e aceite o contrato operacional versionado.
- Configure marca, template e conteúdo público.
- Conecte Mercado Pago, Woovi ou GoatPay com uma credencial válida.
- Crie uma oferta, publique e valide o Pix completo em sandbox.
- Antes de produção, teste confirmação, conciliação, reembolso e webhook.
Adquirentes suportadas
Mercado Pago usa OAuth com PKCE como caminho preferencial; Woovi usa AppID e subconta quando disponível; GoatPay usa API Key para cobranças e o WebSocket oficial para eventos. Uma integração só fica operacional depois de credencial válida e teste real.
Recursos por plano
O Free permite um gateway, uma adquirente e até três módulos comerciais. O Pro libera gateways, adquirentes e módulos ilimitados, domínio próprio, remoção da marca Nash, API, webhooks e logs. API keys e webhooks exigem entitlement Pro validado no servidor.
Primeira chamada
Depois de publicar o gateway, crie uma API key em Backend/API. A chave pertence a um único gateway; seu backend não envia workspaceId ou gatewayId para obter acesso.
curl https://app.nash.lat/api/v1/gateways \
-H "Authorization: Bearer $NASH_API_KEY"