Quickstart: your first Pix to stablecoin transaction

Prerequisites

An approved Mippo LaaS partner account (apply here)
A sandbox API key from your Partner Dashboard

1. Install the SDK

npm install @mippo/laas-sdk

yarn add @mippo/laas-sdk

bun add @mippo/laas-sdk

2. Initialise the client

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

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

Never initialise the SDK client-side. Your API key must stay on your backend server.

3. Submit 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'

In sandbox, any valid CPF format passes KYC and returns riskTier: 'STANDARD'. To test the HIGH risk path, use CPF 000.000.001-91.

4. Initiate a transaction

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

5. Handle the auth challenge

Every transaction returns an auth challenge before a Pix QR code is issued.

Standard Risk (TOTP MFA)
High Risk / 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;
  // Mippo fires a webhook when liveness passes → pixPayload sent via webhook
}

6. Listen for completion

After the user pays via Pix, Mippo fires a transaction.completed webhook to your endpoint. See the Webhooks guide for verification.

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

That’s it. The stablecoin is now in your user’s wallet.

Getting Started

Guides

Quickstart: your first Pix to stablecoin transaction

Prerequisites

1. Install the SDK

2. Initialise the client

3. Submit KYC

4. Initiate a transaction

5. Handle the auth challenge

6. Listen for completion

​Prerequisites

​1. Install the SDK

​2. Initialise the client

​3. Submit KYC

​4. Initiate a transaction

​5. Handle the auth challenge

​6. Listen for completion

Prerequisites

1. Install the SDK

2. Initialise the client

3. Submit KYC

4. Initiate a transaction

5. Handle the auth challenge

6. Listen for completion