Construir o Aplicativo do Seu Cliente (Front-end)

Este guia orienta o time de engenharia a integrar cadastro, login, KYC e operações no front-end do seu aplicativo (PWA, mobile ou web).

1. Cadastro e Login no AWS Cognito

O front-end do seu app fala direto com o AWS Cognito (provedor de identidade do Ether). Nenhuma senha passa pelos seus servidores.

1. Obtenha com a equipe comercial o userPoolId (domínio de login) e o clientId (App Client ID público, sem secret).

2. Integre no seu front-end o SDK oficial:

npm install @aws-amplify/auth

3. Exemplo de fluxo de login:

import { Auth } from '@aws-amplify/auth';

Auth.configure({ userPoolId: 'USER_POOL_ID', userPoolWebClientId: 'CLIENT_ID_PUBLICO' });

// 1. Criar conta
// ⚠️ Nosso User Pool exige o atributo `phone_number` no cadastro (formato E.164,
// ex: "+5511999998888"). Omiti-lo derruba a chamada com:
// InvalidParameterException: Attributes did not conform to the schema:
// phoneNumbers: The attribute phoneNumbers is required
await Auth.signUp({
  username: email,
  password,
  attributes: {
    phone_number: '+5511999998888',
  },
});

// 2. Confirmar e-mail com código recebido de 6 dígitos
await Auth.confirmSignUp(email, confirmationCode);

// 3. Fazer Login
const session = await Auth.signIn(email, password);
const jwt = session.getIdToken().getJwtToken(); // Token de acesso do usuário (JWT)

2. Onboarding (Vinculação de Conta)

Logo após o primeiro login do usuário, envie os dados cadastrais dele para a DEX API usando o token JWT dele. Isso cria o vínculo definitivo com a sua empresa parceira:

Endpoint

curl -X POST https://api.dexkey.finance/v1/users/onboarding \
  -H "Authorization: Bearer $JWT_DO_USUARIO" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nome Completo",
    "phone": "+5511999998888",
    "birthDate": "1990-01-01",
    "nationality": "BR",
    "gender": "MALE",
    "motherName": "Nome da Mãe"
  }'

• gender: "MALE", "FEMALE", "OTHER" ou "PREFER_NOT_TO_SAY"

3. Próximos Passos de Integração

Após o onboarding, utilize as documentações dedicadas para implementar o restante da jornada do cliente:

• Para integrar o preenchimento de endereço e upload de documentos (RG/Selfie):
  👉 Guia de KYC e Perfil do Usuário

• Para integrar o Pix de Depósito/Saque e o Swap de moedas no seu app:
  👉 Guia de Operações Financeiras