{
  "data": {
    "id": "f5c1b8d4-...",
    "status": "pending",
    "amount_cents": 9990,
    "fee_cents": 348,
    "net_cents": 9642,
    "pix_qr_code": "data:image/png;base64,iVBORw0KGgo...",
    "pix_copy_paste": "00020126580014br.gov.bcb.pix...",
    "expires_at": "2026-04-20T05:43:00Z",
    "external_id": "pedido_42",
    "created_at": "2026-04-20T04:43:00Z"
  }
}

{
  "data": {
    "id": "b1c2d3...",
    "status": "processing",
    "gross_cents": 5000,
    "net_cents": 4750,
    "fee_cents": 250,
    "pix_key": "afiliado@email.com",
    "pix_key_type": "email",
    "gateway_id": "tx_...",
    "gateway_status": "PROCESSING",
    "requested_at": "2026-07-14T12:00:00Z"
  }
}

POST https://sua-loja.com/webhook
Headers:
  X-SkinPay-Signature: t=1729400000,v1=<hmac_sha256>
  Content-Type: application/json

Body:
{
  "event": "charge.paid",
  "data": {
    "id": "uuid",
    "status": "paid",
    "amount_cents": 9990,
    "external_id": "pedido_42",
    "paid_at": "2026-04-20T04:50:00Z"
  }
}

import crypto from "crypto";

app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const sig = req.headers["x-skinpay-signature"];
  const [tsPart, v1Part] = sig.split(",");
  const ts = tsPart.split("=")[1];
  const v1 = v1Part.split("=")[1];

  const expected = crypto
    .createHmac("sha256", process.env.WEBHOOK_SECRET)
    .update(`${ts}.${req.body}`)
    .digest("hex");

  if (expected !== v1) return res.status(401).end();

  const event = JSON.parse(req.body);
  if (event.event === "charge.paid") {
    // libera o pedido
  }
  res.status(200).end();
});

Você é um engenheiro integrando a API SkinPay (pagamentos Pix no Brasil) no meu projeto.

CONTEXTO DA API
- Base URL: https://skinpay.pro/api/public/v1
- Autenticação: header "x-api-key: sk_live_xxx" (a chave fica APENAS no backend, nunca no frontend).
- Valores monetários sempre em centavos (integer). Mínimo cobrança 50.
- Manifesto para IA: https://skinpay.pro/llms.txt
- Documentação humana: https://skinpay.pro/docs
- Suporte oficial (Telegram): https://t.me/Skinpayatendimento

ENDPOINTS
1) POST /v1/charges  -> cria cobrança Pix
   Body JSON: { "amount": 9990, "description": "Pedido #42", "external_id": "pedido_42",
                "payer": { "name": "...", "document": "...", "email": "..." },
                "expires_in": 3600 }
   Resposta 201: { "data": { "id", "status", "pix_qr_code" (data:image/png;base64,...),
                              "pix_copy_paste", "expires_at", "amount_cents", "net_cents" } }
2) GET  /v1/charges/:id -> consulta status (pending|paid|expired|cancelled|refunded|failed)
3) GET  /v1/charges -> lista as 50 mais recentes
4) POST /v1/withdrawals -> saque Pix automático (mín R$ 15,00 / máx R$ 1.000,00 por saque)
   Body: { "amount": 5000,                       // centavos, obrigatório
           "pix_key": "cliente@email.com",        // opcional — envia para QUALQUER chave
           "pix_key_type": "email" }              // cpf | cnpj | email | phone | evp
   Header: Idempotency-Key: <seu id> (recomendado para evitar saques duplicados)
   Se pix_key/pix_key_type forem omitidos, usa a chave cadastrada no painel do lojista.
   Ideal para split de afiliados: dispare um saque para cada chave PIX. Taxa: R$ 2,50 por saque.
5) GET  /v1/withdrawals/:id -> consulta status do saque (requested|paid|rejected)

WEBHOOK
- POST na URL cadastrada com header "X-SkinPay-Signature: t=<unix>,v1=<hmac>"
- Verificação: HMAC_SHA256(WEBHOOK_SECRET, `${t}.${rawBody}`) === v1
- Sempre responder 200 rápido; reprocessamento por external_id é idempotente.
- Eventos: charge.paid, charge.expired, charge.refunded

REGRAS QUE VOCÊ DEVE SEGUIR
- Crie um endpoint backend POST /api/checkout que chame /v1/charges e devolva apenas { id, pix_qr_code, pix_copy_paste, expires_at } para o frontend.
- Crie um endpoint POST /api/webhooks/skinpay que valide a assinatura ANTES de ler o body como JSON (use o raw body).
- Marque o pedido como pago somente quando o evento for charge.paid e o status no banco ainda for pendente.
- Use Idempotency-Key (ex.: o id do pedido) ao criar cobranças para evitar duplicidade.
- Nunca exponha sk_live_* no frontend. Use variáveis de ambiente SKINPAY_API_KEY e SKINPAY_WEBHOOK_SECRET.

MINHA STACK: <descreva aqui: ex. Next.js + Prisma + Postgres>
MEU OBJETIVO: <descreva aqui: ex. cobrar R$ 99,90 no checkout e liberar o pedido quando o Pix for pago>

Implemente os arquivos necessários, com tratamento de erros (401, 402, 422, 502) e logs claros.