API PagPix Hub

curl https://pagpixhub.com/api/v1/me \
  -H "Authorization: Bearer bp_live_seu_token"

{
  "error": {
    "code": "validation_error",
    "message": "One or more fields are invalid",
    "details": { "amount_cents": ["amount_cents min R$5,00 (500 cents)"] }
  }
}

curl -X POST https://pagpixhub.com/api/v1/transactions \
  -H "Authorization: Bearer bp_live_seu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 1990,
    "method": "pix",
    "customer": {
      "email": "joao@example.com",
      "name": "João Silva",
      "cpf": "11144477735"
    },
    "description": "Mensalidade Plano Pro",
    "external_reference": "order_42",
    "utm": {
      "source": "fb",
      "medium": "video",
      "campaign": "camp-black-friday",
      "content": "criativo-A",
      "term": "feed",
      "fbclid": "IwAR123...",
      "ttclid": "",
      "gclid": ""
    }
  }'

{
  "id": "tx_clxabc123",
  "public_id": "pag-pix-1990-4829103746",
  "object": "transaction",
  "status": "PENDING",
  "method": "PIX",
  "amount_cents": 1990,
  "fee_cents": 449,
  "net_cents": 1541,
  "currency": "BRL",
  "pix": {
    "copy_paste": "00020126580014BR.GOV.BCB.PIX...",
    "expires_at": "2026-06-01T16:30:00.000Z"
  },
  "split": null,
  "created_at": "2026-06-01T15:30:00.000Z"
}

curl -X POST https://pagpixhub.com/api/v1/transactions \
  -H "Authorization: Bearer bp_live_seu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 5000,
    "method": "pix",
    "customer": { "email": "cliente@example.com" },
    "description": "Acesso VIP",
    "split": {
      "recipient": "parceiro@example.com",
      "percent": 30
    }
  }'

{
  "id": "tx_clxabc123",
  "public_id": "pag-pix-1990-4829103746",
  "object": "transaction",
  "status": "PENDING",
  "pix_status": "generating",
  "method": "PIX",
  "amount_cents": 1990,
  "pix": { "copy_paste": null, "expires_at": "2026-06-01T16:30:00.000Z" },
  "message": "PIX em geracao. Faça GET /api/v1/transactions/tx_clxabc123 ate pix.copy_paste ficar disponivel (~5-30s)."
}

async function esperarPix(id, token, limiteMs = 60000) {
  const ate = Date.now() + limiteMs;
  while (Date.now() < ate) {
    const r = await fetch(`https://pagpixhub.com/api/v1/transactions/${id}`, {
      headers: { Authorization: `Bearer ${token}` },
    });
    const tx = await r.json();
    if (tx.pix_status === "ready") return tx.pix.copy_paste;
    if (["failed", "expired", "paid"].includes(tx.pix_status)) {
      throw new Error("cobranca terminou em " + tx.pix_status);
    }
    await new Promise((s) => setTimeout(s, 2000));
  }
  throw new Error("tempo limite esperando o PIX");
}

curl https://pagpixhub.com/api/v1/transactions/tx_clxabc123 \
  -H "Authorization: Bearer bp_live_seu_token"

# mesma transação, pelo public_id
curl https://pagpixhub.com/api/v1/transactions/pag-pix-1990-4829103746 \
  -H "Authorization: Bearer bp_live_seu_token"

{
  "id": "tx_clxabc123",
  "public_id": "pag-pix-1990-4829103746",
  "object": "transaction",
  "status": "PAID",
  "pix_status": "paid",
  "method": "PIX",
  "amount_cents": 1990,
  "fee_cents": 449,
  "net_cents": 1541,
  "currency": "BRL",
  "customer": { "email": "joao@example.com", "name": "João Silva", "cpf": "11144477735", "phone": null },
  "pix": {
    "qr_code": null,
    "copy_paste": "00020126580014BR.GOV.BCB.PIX...",
    "expires_at": "2026-06-01T16:30:00.000Z"
  },
  "external_reference": "order_42",
  "metadata": { "attendant_code": "A123" },
  "end_to_end_id": "E12345678202606011530abcdef12345",
  "paid_at": "2026-06-01T15:32:10.000Z",
  "created_at": "2026-06-01T15:30:00.000Z",
  "updated_at": "2026-06-01T15:32:10.000Z"
}

curl https://pagpixhub.com/api/v1/transactions?status=PAID&limit=50 \
  -H "Authorization: Bearer bp_live_seu_token"

{
  "data": [
    {
      "id": "tx_clxabc123",
      "public_id": "pag-pix-1990-4829103746",
      "object": "transaction",
      "product_id": "prd_xxx",
      "checkout_id": "ck_xxx",
      "customer": { "email": "...", "name": "...", "cpf": "...", "phone": "..." },
      "amount_cents": 1990,
      "fee_cents": 449,
      "net_cents": 1541,
      "currency": "BRL",
      "method": "PIX",
      "status": "PAID",
      "pix": { "qr_code": "...", "copy_paste": "...", "expires_at": "..." },
      "card": null,
      "tracking": { "utm_source": "...", "utm_medium": "...", "fbclid": "..." },
      "split": { "recipient": "parceiro@example.com", "amount_cents": 450 },
      "paid_at": "2026-06-01T15:32:00.000Z",
      "created_at": "2026-06-01T15:30:00.000Z",
      "updated_at": "2026-06-01T15:32:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "tx_clxabc123"
}

curl https://pagpixhub.com/api/v1/me -H "Authorization: Bearer bp_live_seu_token"

{
  "id": "usr_xxx",
  "email": "voce@example.com",
  "name": "Você",
  "balance_cents": 12345,
  "api_card_enabled": false
}

curl https://pagpixhub.com/api/v1/balance -H "Authorization: Bearer bp_live_seu_token"

{
  "object": "balance",
  "currency": "BRL",
  "available_cents": 50000,        // SACÁVEL agora (já liberado)
  "pending_pix_cents": 12000,      // PIX pago, ainda em holding
  "pending_card_cents": 0,         // Cartão pago, ainda em holding (D+X)
  "retained_card_cents": 0,        // Retenção de cartão (libera no fim do período)
  "in_withdrawal_cents": 0,        // Saques abertos já debitados
  "upcoming_releases": [
    { "transaction_id": "tx_xxx", "transaction_public_id": "pag-pix-12000-4829103746", "date": "2026-06-02T10:00:00.000Z", "cents": 12000, "kind": "pix_release", "method": "PIX" }
  ]
}

curl -X POST https://pagpixhub.com/api/v1/withdrawals \
  -H "Authorization: Bearer bp_live_seu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 10000,
    "method": "pix",
    "pix_key": "voce@example.com",
    "pix_key_type": "email"
  }'

{
  "id": "wd_clxabc123",
  "object": "withdrawal",
  "status": "PENDING",
  "method": "pix",
  "amount_cents": 10000,
  "fee_cents": 500,
  "net_cents": 9500,
  "pix_key": "voce@example.com",
  "pix_key_type": "email",
  "wallet_address": null,
  "fail_reason": null,
  "paid_at": null,
  "created_at": "2026-06-01T15:30:00.000Z",
  "updated_at": "2026-06-01T15:30:00.000Z"
}

curl "https://pagpixhub.com/api/v1/withdrawals?status=PAID&limit=50" \
  -H "Authorization: Bearer bp_live_seu_token"

{
  "id": "evt_<deliveryId>",          // ESTÁVEL entre retentativas, dedupe por ele
  "type": "transaction.paid",
  "created": 1730476320,             // unix timestamp (segundos)
  "data": { /* objeto do evento (ver abaixo) */ }
}

{
  "id": "tx_clxabc123",
  "public_id": "pag-pix-1990-4829103746",
  "product_id": "prd_xxx",
  "checkout_id": null,
  "amount_cents": 1990,
  "fee_cents": 449,
  "net_cents": 1541,
  "currency": "BRL",
  "method": "PIX",
  "status": "PAID",
  "external_reference": "order_42",
  "end_to_end_id": "E18236120202609111335s0000abc123",
  "metadata": { "attendant_code": "A123" },
  "customer": { "email": "...", "name": "...", "cpf": "...", "phone": "..." },
  "tracking": { "utm_source": "fb", "utm_medium": "video", "utm_campaign": "...",
                "utm_content": "...", "utm_term": "...", "fbclid": "...",
                "ttclid": "...", "gclid": "..." },
  "receipt_url": null,
  "paid_at": "2026-06-01T15:32:00.000Z",
  "created_at": "2026-06-01T15:30:00.000Z"
}

{
  "id": "wd_xxx",
  "object": "withdrawal",
  "status": "PAID",
  "method": "pix",
  "amount_cents": 10000,
  "fee_cents": 500,
  "net_cents": 9500,
  "pix_key": "voce@example.com",
  "wallet_address": null,
  "fail_reason": null,
  "paid_at": "2026-06-01T16:00:00.000Z"
}

PagPixHub-Signature: t=1730476320,v1=9f86d081884c7d659...

import crypto from "node:crypto";

// rawBody = corpo CRU (string), NÃO o objeto re-serializado.
function verifyWebhook(rawBody, headerValue, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(
    headerValue.split(",").map((kv) => kv.split("="))
  ); // { t, v1 }
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; // replay
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(parts.v1)
  );
}

// 1. Cria PIX (sem produto, funciona pra qualquer conta)
const res = await fetch("https://pagpixhub.com/api/v1/transactions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PAGPIXHUB_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount_cents: 1990,
    method: "pix",
    customer: {
      email: "cliente@example.com",
      name: "Cliente Exemplo",
      cpf: "11144477735",
    },
    description: "Pedido #42",
    external_reference: "order_42",
  }),
});

const tx = await res.json();
if (!res.ok) throw new Error(tx.error.message);

// 2. Mostra QR pro cliente
console.log("Copia-cola PIX:", tx.pix.copy_paste);
console.log("Expira em:", tx.pix.expires_at);

// 3. Espera webhook 'transaction.paid' chegar no seu endpoint
//    OU pollie GET /transactions/{id} periodicamente
//    OU melhor: configure o webhook em Dashboard → Integrações