Integra pagaments Redsys a Andorra amb una API clara i sense custòdia.

import crypto from "node:crypto";

function verifyPontPaySignature(rawBody: string, signature: string) {
  const expected = crypto
    .createHmac("sha256", process.env.PONTPAY_WEBHOOK_SECRET!)
    .update(rawBody)
    .digest("hex");

  const received = Buffer.from(signature, "hex");
  const expectedBuffer = Buffer.from(expected, "hex");

  return (
    received.length === expectedBuffer.length &&
    crypto.timingSafeEqual(received, expectedBuffer)
  );
}

export async function POST(request: Request) {
  const rawBody = await request.text();
  const signature = request.headers.get("x-pontpay-signature") ?? "";

  if (!verifyPontPaySignature(rawBody, signature)) {
    return Response.json({ error: "invalid_signature" }, { status: 400 });
  }

  const event = JSON.parse(rawBody) as {
    type: string;
    data: { id: string; orderId: string; status: string };
  };

  // Store event.type + data.id before side effects.
  // Fulfill only after payment.succeeded or after GET /payments/{id}.

  return Response.json({ received: true });
}

async function pontpayRequest(path: string, init: RequestInit) {
  for (let attempt = 0; attempt < 3; attempt += 1) {
    const response = await fetch(`https://pontpay.ad${path}`, init);

    if (response.ok) {
      return response.json();
    }

    if (![408, 409, 429, 500, 502, 503, 504].includes(response.status)) {
      const payload = await response.json().catch(() => ({}));
      throw new Error(payload.error ?? `pontpay_http_${response.status}`);
    }

    await new Promise((resolve) => setTimeout(resolve, 300 * 2 ** attempt));
  }

  throw new Error("pontpay_retry_exhausted");
}

Estás integrando PontPay en mi backend.
Antes de escribir codigo, lee esta documentacion publica: https://pontpay.ad/developers

Reglas obligatorias:
- Usa la clave de API solo desde servidor. Nunca la expongas en navegador o app movil.
- PontPay no custodia fondos: Redsys y el banco del comercio procesan y liquidan.
- Crea pagos con POST /api/v1/payments, PontPay-Version e Idempotency-Key estable.
- Redirige al comprador a payment.checkoutUrl.
- No marques pedidos como pagados por successUrl. Usa webhook verificado o GET /payments/{id}.
- Las URLs de webhook deben ser HTTPS con hostname publico. No uses localhost, IPs, .local, .internal ni credenciales en URL.
- Verifica X-PontPay-Signature sobre el raw body exacto.
- Deduplica eventos por type + data.id.
- Si falta un campo o endpoint en la documentacion, pregunta. No inventes contratos.

Implementa:
1. Crear pago desde backend.
2. Redireccion a checkoutUrl.
3. Webhook firmado con idempotencia local.
4. Consulta final del pago antes de entregar.
5. Tests o smoke check acotados.