SDKs

Hoy el SDK publicado es @payforce/node. Cubre pagos, checkouts, clientes, suscripciones, facturas, payment links y verificación de webhooks.

Instalación

npm install @payforce/node

Cliente

import { PayForce } from "@payforce/node";

const pf = new PayForce({
  accessToken: process.env.PAYFORCE_SECRET_KEY!,
  // baseUrl: "https://sandbox-api.payforce.co", // claves pf_test_
});

const checkout = await pf.checkouts.create({ amount: 3990, currency: "eur" });
const payment = await pf.payments.get("pay_123");
const page = await pf.payments.list({ page: 1, limit: 20, status: "succeeded" });

Idempotencia

await pf.payments.create(
  { amount: 3990, currency: "eur" },
  { idempotencyKey: "order-1042" },
);

Webhooks

pf.webhooks.verify comprueba X-PayForce-Signature. Usa el body crudo, no el JSON parseado.

const ok = pf.webhooks.verify(rawBody, signatureHeader, webhookSecret);

La referencia de cada ruta está en Referencia de API.