API e webhooks

Coloque Pix no seu produto com poucas linhas.

Uma API REST direta, webhooks assinados e SDK em JS/TS. Integre em minutos, ou deixe a sua IA fazer por você com o /llms.txt.

Ver documentação Criar conta

$npm install @troqpay/sdk

checkout.ts

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

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

// cria uma cobrança Pix
const checkout = await troqpay.checkouts.create(
  {
    amount: 12990,
    description: "Plano Pro",
    externalId: "order_1001",
  },
  { idempotencyKey: "order_1001" },
);

console.log(checkout.checkoutUrl);

Por que integrar aqui

Feito pra dev: claro, previsível e confiável.

API REST simples

Endpoints claros, chaves de teste e produção separadas, e idempotência pra reenviar sem cobrar duas vezes.

Webhooks assinados

Cobrança criada, paga ou expirada chega assinada no header x-troqpay-signature. Você confia no evento sem consultar a API.

SDK oficial, opcional

@troqpay/sdk em JavaScript e TypeScript pra ir mais rápido. Ou chame a API direto, em qualquer linguagem.

Quickstart

Receber um Pix é reagir a um evento.

Da chave à confirmação, o caminho é curto. O webhook avisa o seu sistema na hora, sem ficar de olho na API.

Pegue sua chave

Gere uma chave trq_test_ no painel e integre sem tocar em produção.

Crie a cobrança

Uma chamada cria o checkout Pix e devolve o link pronto pra pagar.

Confirme pelo webhook

O evento checkout.paid avisa o seu sistema na hora que o Pix cai.

webhook.ts

// seu endpoint recebe os eventos da TroqPay
app.post("/webhooks/troqpay", (req, res) => {
  const signature = req.headers["x-troqpay-signature"];

  // valide a assinatura antes de confiar
  if (!assinaturaValida(req.body, signature)) {
    return res.sendStatus(400);
  }

  if (req.body.type === "checkout.paid") {
    // libere o acesso ou dê baixa no pedido
  }

  res.sendStatus(200);
});

API REST: chame de onde você já trabalha. O SDK é JS/TS; a API, de qualquer linguagem.