API y webhooks

Integra Pix en tu producto con pocas líneas de código.

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 con TroqPay

Hecho para desarrolladores: claro, predecible y confiable.

API REST simple

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

Webhooks firmados

Los eventos de pagos creados, confirmados o vencidos incluyen el encabezado x-troqpay-signature para que puedas verificarlos sin consultar la API.

SDK oficial, opcional

@troqpay/sdk en JavaScript y TypeScript para avanzar más rápido. También puedes llamar directamente a la API desde cualquier lenguaje.

Quickstart

Un pago Pix es un evento.

De la clave a la confirmación, el camino es corto. Los webhooks actualizan tu sistema sin consultar constantemente la API.

Obtén 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 un enlace de pago.

Confirma por el webhook

El evento checkout.paid avisa a tu sistema en cuanto se confirma el pago 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 marca el pedido como pagado
  }

  res.sendStatus(200);
});

API REST: úsala desde tu stack actual. El SDK admite JS/TS y la API funciona con cualquier lenguaje.