Iniciar uma transação Pix para stablecoin

Toda transação exige um auth challenge antes que um QR code Pix seja emitido. O tipo de challenge depende do riskTier do cliente definido no KYC.

Risk Tier	Auth Challenge
`STANDARD`	TOTP MFA (`MFA_TOTP`)
`HIGH` / `PEP`	Verificação de liveness (`LIVENESS`)

Request

string

obrigatório

Sua API key.

string

obrigatório

Token de POST /v1/laas/kyc/submit. Não pode estar expirado.

number

obrigatório

Valor em BRL (R$). Mínimo: 50. Máximo: 50000 por transação.

string

obrigatório

Stablecoin a receber: "USDT" ou "USDC".

string

obrigatório

Endereço de wallet compatível com EVM (checksum EIP-55). Rede Polygon.

Request

{
  "kycToken": "kyc_1719000000_abc123",
  "amountBrl": 500,
  "asset": "USDT",
  "walletAddress": "0xYourUserWalletAddress"
}

Response

Standard Risk
High Risk / PEP

string

ID da transação. Utilize nas chamadas confirm-mfa e status.

string

PENDING_AUTH

string

MFA_TOTP

string

Instrução legível para exibir ao seu usuário.

{
  "success": true,
  "data": {
    "transactionId": "tx_1719000000_xyz",
    "status": "PENDING_AUTH",
    "authChallenge": {
      "type": "MFA_TOTP",
      "instruction": "Request the 6-digit TOTP code from your user"
    }
  }
}

string

LIVENESS

string

URL para redirecionar o usuário para verificação de liveness. Válida por 10 minutos.

{
  "success": true,
  "data": {
    "transactionId": "tx_1719000000_xyz",
    "status": "PENDING_AUTH",
    "authChallenge": {
      "type": "LIVENESS",
      "instruction": "User must complete liveness verification",
      "livenessUrl": "https://partners.mippo.io/liveness/tx_1719000000_xyz"
    }
  }
}

Quando o liveness é aprovado, a Supercosmos dispara um webhook transaction.pix_ready com o pixPayload. Você não precisa fazer polling.

Visão geral

KYC

Transações

Acesso

Iniciar uma transação Pix para stablecoin

Request

Response

​Request

​Response

Request

Response