Build automated payment flows

Developers can request a quote, create a buy order, show the PIX QR Code to the payer, and listen for webhook confirmation. The API is designed for server-to-server usage with Bearer secret keys.

PIX to USDT wallet

To generate a real PIX QR Code, create a buy order with BRL amount, USDT asset, destination BSC wallet and optional customer audit fields. Each request creates a unique buy order and returns the PIX payload, QR Code, status URL and access token.

POST /buy
Authorization: Bearer sk_live_xxx
Content-Type: application/json

{
  "fiat": "BRL",
  "asset": "USDT",
  "amount": 500,
  "wallet": "0x174208255ECc40481f7fD7c34EE6a9A5B66B4339",
  "paymentMethod": "pix",
  "customer": {
    "name": "Maria Silva",
    "email": "maria@example.com",
    "cpf": "12345678909",
    "phone": "11999999999",
    "birthDate": "1990-05-20",
    "address": {
      "line1": "Av Paulista",
      "number": "1000",
      "line2": "Apto 101",
      "district": "Bela Vista",
      "city": "Sao Paulo",
      "state": "SP",
      "postalCode": "01310100",
      "country": "BR"
    }
  }
}

Response 201
{
  "id": "buy_order_id",
  "buyId": "buy_order_id",
  "accessToken": "customer_access_token",
  "status": "aguardando_pix",
  "fiatCurrency": "BRL",
  "paymentMethod": "pix",
  "totalFiat": 510.30,
  "cryptoAmount": 96.52,
  "asset": "USDT",
  "network": "BSC",
  "destAddress": "0x174208255ECc40481f7fD7c34EE6a9A5B66B4339",
  "qrCodeUrl": "https://...",
  "payment": {
    "provider": "pagseguro",
    "pixKey": "...",
    "qrCodeUrl": "https://..."
  },
  "statusUrl": "/api/buy/buy_order_id?accessToken=customer_access_token"
}

Consolidated with the backend path: /buy accepts customer name, email, CPF, phone, birth date and address, forwards those fields to the PIX provider when creating the PagBank charge, stores audit hashes locally, and returns the PIX QR payload. Current settlement supports USDT delivery on BSC; BTC and EURUSDT remain roadmap assets.

USDT to PIX BRL

For sell flows, the customer sends USDT to the generated deposit address and receives BRL via PIX after on-chain confirmation.

POST /sell
Authorization: Bearer sk_live_xxx

{
  "asset": "USDT",
  "network": "BSC",
  "amount": 500,
  "depositAddress": "0x174208255ECc40481f7fD7c34EE6a9A5B66B4339",
  "pixCpf": "12345678909"
}

Webhooks

Use webhooks to automate fulfillment when a payment is completed or crypto is sent.

{
  "event": "payment.completed",
  "orderId": "ord_123",
  "status": "paid",
  "asset": "USDT",
  "amount": "96.52",
  "timestamp": "2026-07-04T00:00:00Z"
}

Roadmap

Phase 4 will add MCP, n8n, Zapier, Make and OpenAI Agents examples. Phase 5 will expand assets, countries and payment rails. Bridge, pool, AMM, DEX and yield are intentionally out of scope.