Início rápido: sua primeira transação Pix a stablecoin - Supercosmos for Platforms

Pré-requisitos

Uma conta de desenvolvedor aprovada no Supercosmos for Platforms (cadastre-se aqui)
Uma chave de API de sandbox obtida no seu painel do desenvolvedor

1. Instale o SDK

npm install @mippo/laas-sdk

yarn add @mippo/laas-sdk

bun add @mippo/laas-sdk

2. Inicialize o cliente

import { MippoLaas } from '@mippo/laas-sdk';

const mippo = new MippoLaas({
  apiKey: process.env.MIPPO_API_KEY,  // sk_test_... for sandbox
  environment: 'sandbox',
});

Nunca inicialize o SDK no lado do cliente. Sua chave de API deve permanecer no seu servidor backend.

3. Envie o KYC

const client = await mippo.kyc.submit({
  cpf: '123.456.789-09',
  biometricHash: 'sha256:your_biometric_hash',
  personType: 'PF',
});

// client.token → pass to transactions
// client.riskTier → 'STANDARD' | 'HIGH' | 'PEP'

No sandbox, qualquer CPF em formato válido passa no KYC e retorna riskTier: 'STANDARD'. Para testar o fluxo de risco HIGH, use o CPF 000.000.001-91.

4. Inicie uma transação

const tx = await mippo.transactions.initiate({
  kycToken: client.token,
  amountBrl: 500,
  asset: 'USDT',
  walletAddress: '0xYourUserWalletAddress',
});

5. Trate o desafio de autenticação

Toda transação retorna um desafio de autenticação antes que um QR code Pix seja emitido.

Risco padrão (MFA TOTP)
Alto risco / PEP (Liveness)

if (tx.authChallenge?.type === 'MFA_TOTP') {
  // Show your user a prompt to enter their TOTP code
  const totpCode = await promptUserForTotp();

  const confirmed = await mippo.transactions.confirmMfa({
    transactionId: tx.transactionId,
    totpCode,
  });

  // confirmed.pixPayload → render as QR code for the user
  console.log(confirmed.pixPayload);
}

if (tx.authChallenge?.type === 'LIVENESS') {
  // Redirect user to the liveness URL or embed it in a WebView
  const livenessUrl = tx.authChallenge.livenessUrl;
  window.location.href = livenessUrl;
  // Supercosmos fires a webhook when liveness passes → pixPayload sent via webhook
}

6. Aguarde a conclusão

Depois que o usuário paga via Pix, a Supercosmos dispara um webhook transaction.completed para o seu endpoint. Consulte o guia de Webhooks para verificação.

// transaction.completed payload
{
  "event": "transaction.completed",
  "data": {
    "transactionId": "tx_1719000000_xyz",
    "txHash": "0xabc123...",
    "asset": "USDT",
    "amount": "90.25",  // after Supercosmos fee
    "walletAddress": "0xYourUserWalletAddress"
  }
}

Pronto. A stablecoin já está na carteira do seu usuário.