API y webhooks

Pon Pix en tu producto con pocas líneas.

Una API REST directa, webhooks firmados y SDK en JS/TS. Integra en minutos, o deja que tu IA lo haga por ti con /llms.txt.

Ver documentación Crear cuenta

$npm install @troqpay/sdk

checkout.ts

import { Troqpay } from "@troqpay/sdk";

const troqpay = new Troqpay({
  apiKey: process.env.TROQPAY_API_KEY!,
});

// crea un cobro Pix
const checkout = await troqpay.checkouts.create(
  {
    amount: 12990,
    description: "Plan Pro",
    externalId: "order_1001",
  },
  { idempotencyKey: "order_1001" },
);

console.log(checkout.checkoutUrl);

Por qué integrar aquí

Hecho para dev: claro, previsible y confiable.

API REST simple

Endpoints claros, claves de prueba y producción separadas, e idempotencia para reenviar sin cobrar dos veces.

Webhooks firmados

Cobro creado, pagado o expirado llega firmado en el header x-troqpay-signature. Confías en el evento sin consultar la API.

SDK oficial, opcional

@troqpay/sdk en JavaScript y TypeScript para ir más rápido. O llama la API directo, en cualquier lenguaje.

Quickstart

Recibir un Pix es reaccionar a un evento.

De la clave a la confirmación, el camino es corto. El webhook avisa a tu sistema al instante, sin estar mirando la API.

Toma tu clave

Genera una clave trq_test_ en el panel e integra sin tocar producción.

Crea el cobro

Una llamada crea el checkout Pix y devuelve el link listo para pagar.

Confirma por el webhook

El evento checkout.paid avisa a tu sistema en el momento en que cae el Pix.

webhook.ts

// tu endpoint recibe los eventos de TroqPay
app.post("/webhooks/troqpay", (req, res) => {
  const signature = req.headers["x-troqpay-signature"];

  // valida la firma antes de confiar
  if (!firmaValida(req.body, signature)) {
    return res.sendStatus(400);
  }

  if (req.body.type === "checkout.paid") {
    // libera el acceso o da de baja el pedido
  }

  res.sendStatus(200);
});

API REST: llámala desde donde ya trabajas. El SDK es JS/TS; la API, cualquier lenguaje.