https://api.pagpayze.com.br

{
  "hasError": false,
  "data": { "transaction_id": "7KQ2M9XA4T1B", "status": "PENDING" }
}

{
  "hasError": true,
  "error": "API key não fornecida. Envie a chave no header X-API-Key",
  "errorFields": [],
  "statusCode": 401,
  "timestamp": "2026-10-08T15:19:01.612Z",
  "path": "/api/v1/direct-payments"
}

pk_live_0123456789abcdef0123456789abcdef0123456789abcdef

POST /api/v1/direct-payments HTTP/1.1
Host: api.pagpayze.com.br
Content-Type: application/json
X-API-Key: pk_live_…

curl -X POST https://api.pagpayze.com.br/api/v1/direct-payments \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYZE_API_KEY" \
  -d '{
    "amount": 15000,
    "description": "Assinatura anual",
    "paymentMethod": "pix",
    "customer": {
      "name": "Maria Souza",
      "email": "maria@exemplo.com",
      "document": "12345678909",
      "phone": "+5511999999999",
      "birthDate": "15/01/1990",
      "address": {
        "zipCode": "01310100",
        "street": "Avenida Paulista",
        "number": "1000",
        "complement": "Sala 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP"
      },
      "utm": { "source": "google", "medium": "cpc", "campaign": "lancamento" }
    }
  }'

const res = await fetch("https://api.pagpayze.com.br/api/v1/direct-payments", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.PAYZE_API_KEY,
  },
  body: JSON.stringify({
    amount: 15000,
    description: "Assinatura anual",
    paymentMethod: "pix",
    customer: {
      name: "Maria Souza",
      email: "maria@exemplo.com",
      document: "12345678909",
      phone: "+5511999999999",
      birthDate: "15/01/1990",
      address: {
        zipCode: "01310100",
        street: "Avenida Paulista",
        number: "1000",
        complement: "Sala 101",
        district: "Bela Vista",
        city: "São Paulo",
        state: "SP",
      },
      utm: { source: "google", medium: "cpc", campaign: "lancamento" },
    },
  }),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error} ${body.errorFields.join("; ")}`);

$payload = [
  "amount" => 15000,
  "description" => "Assinatura anual",
  "paymentMethod" => "pix",
  "customer" => [
    "name" => "Maria Souza",
    "email" => "maria@exemplo.com",
    "document" => "12345678909",
    "phone" => "+5511999999999",
    "birthDate" => "15/01/1990",
    "address" => [
      "zipCode" => "01310100",
      "street" => "Avenida Paulista",
      "number" => "1000",
      "complement" => "Sala 101",
      "district" => "Bela Vista",
      "city" => "São Paulo",
      "state" => "SP",
    ],
    "utm" => ["source" => "google", "medium" => "cpc", "campaign" => "lancamento"],
  ],
];

$ch = curl_init("https://api.pagpayze.com.br/api/v1/direct-payments");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Key: " . getenv("PAYZE_API_KEY")],
  CURLOPT_POSTFIELDS => json_encode($payload),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST https://api.pagpayze.com.br/api/v1/direct-payments \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYZE_API_KEY" \
  -d '{
    "amount": 9990,
    "description": "Pedido 1234",
    "paymentMethod": "pix",
    "customer": { "name": "João da Silva", "email": "joao@exemplo.com", "document": "12345678909" }
  }'

const res = await fetch("https://api.pagpayze.com.br/api/v1/direct-payments", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": process.env.PAYZE_API_KEY },
  body: JSON.stringify({
    amount: 9990,
    description: "Pedido 1234",
    paymentMethod: "pix",
    customer: { name: "João da Silva", email: "joao@exemplo.com", document: "12345678909" },
  }),
});
const { data } = await res.json();
// Para o front: só o copia-e-cola e o valor
return { transactionId: data.transaction_id, pix: data.payment_data.pix_key, valor: data.total_value };

$ch = curl_init("https://api.pagpayze.com.br/api/v1/direct-payments");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Key: " . getenv("PAYZE_API_KEY")],
  CURLOPT_POSTFIELDS => json_encode([
    "amount" => 9990,
    "description" => "Pedido 1234",
    "paymentMethod" => "pix",
    "customer" => ["name" => "João da Silva", "email" => "joao@exemplo.com", "document" => "12345678909"],
  ]),
]);
$data = json_decode(curl_exec($ch), true)["data"];
curl_close($ch);
$copiaECola = $data["payment_data"]["pix_key"];

async function aguardarPagamento(transactionId, { intervalo = 10000, limite = 30 * 60 * 1000 } = {}) {
  const url = `https://api.pagpayze.com.br/api/v1/payments/${transactionId}/status`;
  const fim = Date.now() + limite;
  while (Date.now() < fim) {
    const res = await fetch(url);
    if (res.ok) {
      const { data } = await res.json();
      if (data.status === "AUTHORIZED") return "pago";
      if (["REJECTED", "CANCELED"].includes(data.status)) return "nao-pago";
    }
    await new Promise((r) => setTimeout(r, intervalo));
  }
  return "tempo-esgotado";
}

curl -X POST https://api.pagpayze.com.br/api/v1/direct-payments \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYZE_API_KEY" \
  -d '{
    "amount": 1612,
    "description": "Pedido 1234",
    "paymentMethod": "bizum",
    "returnUrl": "https://loja.exemplo.com/pedido/1234/aguardando",
    "sourceUrl": "https://loja.exemplo.com/checkout",
    "customer": { "name": "Ana García López", "email": "ana@exemplo.com" }
  }'

const res = await fetch("https://api.pagpayze.com.br/api/v1/direct-payments", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": process.env.PAYZE_API_KEY },
  body: JSON.stringify({
    amount: Math.round(pedido.totalEur * 100), // euros → centavos
    description: `Pedido ${pedido.id}`,
    paymentMethod: "bizum",
    returnUrl: `https://loja.exemplo.com/pedido/${pedido.id}/aguardando`,
    sourceUrl: "https://loja.exemplo.com/checkout",
    customer: { name: pedido.nome, email: pedido.email },
  }),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);

await salvarTransacao(pedido.id, body.data.transaction_id);
// Para o front: só a sessão (e o valor, se for exibir)
return { session: body.data.payment_data.session, valor: body.data.total_value, moeda: body.data.currency };

$ch = curl_init("https://api.pagpayze.com.br/api/v1/direct-payments");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Key: " . getenv("PAYZE_API_KEY")],
  CURLOPT_POSTFIELDS => json_encode([
    "amount" => 1612, // 16,12 € em centavos
    "description" => "Pedido 1234",
    "paymentMethod" => "bizum",
    "returnUrl" => "https://loja.exemplo.com/pedido/1234/aguardando",
    "sourceUrl" => "https://loja.exemplo.com/checkout",
    "customer" => ["name" => "Ana García López", "email" => "ana@exemplo.com"],
  ]),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$session = $body["data"]["payment_data"]["session"]; // repasse ao front

{
  "hasError": false,
  "data": {
    "transaction_id": "Q8W3E5R7T9Y2",
    "total_value": 16.12,
    "currency": "EUR",
    "status": "PENDING",
    "email": "ana@exemplo.com",
    "payment_method": "bizum",
    "payment_data": {
      "payment_id": "…",
      "status": "PENDING",
      "status_detail": "WAITING_PAYMENT",
      "total_transaction_value": 16.12,
      "currency": "EUR",
      "amount": 16.12,
      "exchange_rate": 6.2,
      "session": {
        "session_token": "…",
        "public_key": "…",
        "account": null,
        "transaction_id": "…",
        "sdk_url": "https://compra-segura.pagpayze.com.br/sdk/v1/checkout.js",
        "sandbox": false
      }
    }
  }
}

<div id="pagamento-bizum"></div>
<!-- use a URL de session.sdk_url -->
<script src="https://compra-segura.pagpayze.com.br/sdk/v1/checkout.js"></script>

// session = payment_data.session, entregue pelo SEU servidor
CheckoutSDK.mount({
  container: "#pagamento-bizum",
  session,
  locale: "es",
  onSuccess: () => mostrarAguardando(), // não é confirmação de pagamento
  onError: (e) => console.warn(e.code, e.message),
}).catch((e) => mostrarErro(e.message));

<div id="pagamento"></div>
<script src="https://compra-segura.pagpayze.com.br/sdk/v1/checkout.js"></script>

const form = await CheckoutSDK.mount({
  container: "#pagamento",          // elemento ou seletor CSS
  session,                          // payment_data.session, como veio da API
  locale: "es",                     // "pt" | "es" | "en" | "auto"
  appearance: { accent: "#2E7CF6", radius: "8px", font: "inherit" },
  onReady: () => esconderCarregando(),
  onChange: ({ canConfirm, total }) => {},
  onSuccess: (r) => mostrarAguardando(), // tentativa aceita, NÃO é pagamento confirmado
  onError: (e) => console.warn(e.code, e.message),
});

// Ao sair da página ou desmontar o componente:
form.destroy();

const botao = document.querySelector("#pagar");
botao.disabled = true;

const form = await CheckoutSDK.mount({
  container: "#pagamento",
  session,
  button: false,
  onChange: ({ canConfirm }) => { botao.disabled = !canConfirm; },
});

botao.addEventListener("click", () => form.confirm());

import { useEffect, useRef } from "react";

function carregarSdk(src) {
  return new Promise((resolve, reject) => {
    if (window.CheckoutSDK) return resolve(window.CheckoutSDK);
    const s = document.createElement("script");
    s.src = src;
    s.onload = () => resolve(window.CheckoutSDK);
    s.onerror = () => reject(new Error("Não foi possível carregar o formulário"));
    document.head.appendChild(s);
  });
}

export function FormularioBizum({ session, onAceito, onErro }) {
  const ref = useRef(null);

  useEffect(() => {
    let form;
    let cancelado = false;
    carregarSdk(session.sdk_url)
      .then((sdk) => {
        if (cancelado || !ref.current) return;
        return sdk.mount({
          container: ref.current,
          session,
          locale: "es",
          onSuccess: onAceito,
          onError: (e) => onErro?.(e.message),
        });
      })
      .then((f) => {
        form = f;
        if (cancelado) form?.destroy();
      })
      .catch((e) => onErro?.(e.message));

    return () => {
      cancelado = true;
      form?.destroy();
    };
  }, [session.session_token]);

  return <div ref={ref} />;
}

curl -X POST https://api.pagpayze.com.br/api/v1/direct-payments \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYZE_API_KEY" \
  -d '{
    "amount": 37400,
    "description": "Pedido 1234",
    "paymentMethod": "spei",
    "sourceUrl": "https://loja.exemplo.com/checkout",
    "customer": {
      "name": "Sofía Hernández López",
      "email": "sofia@exemplo.com",
      "document": "HEGS900101MDFRRF09"
    }
  }'

const res = await fetch("https://api.pagpayze.com.br/api/v1/direct-payments", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": process.env.PAYZE_API_KEY },
  body: JSON.stringify({
    amount: Math.round(pedido.totalMxn * 100), // pesos → centavos
    description: `Pedido ${pedido.id}`,
    paymentMethod: "spei",
    sourceUrl: "https://loja.exemplo.com/checkout",
    customer: {
      name: pedido.nome,
      email: pedido.email,
      document: pedido.curpOuRfc.toUpperCase().replace(/[\s.-]/g, ""),
    },
  }),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);

await salvarTransacao(pedido.id, body.data.transaction_id);
return { spei: body.data.payment_data.spei, valor: body.data.total_value, moeda: body.data.currency };

$ch = curl_init("https://api.pagpayze.com.br/api/v1/direct-payments");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Key: " . getenv("PAYZE_API_KEY")],
  CURLOPT_POSTFIELDS => json_encode([
    "amount" => 37400, // MX$ 374,00 em centavos
    "description" => "Pedido 1234",
    "paymentMethod" => "spei",
    "sourceUrl" => "https://loja.exemplo.com/checkout",
    "customer" => [
      "name" => "Sofía Hernández López",
      "email" => "sofia@exemplo.com",
      "document" => "HEGS900101MDFRRF09",
    ],
  ]),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$spei = $body["data"]["payment_data"]["spei"]; // CLABE e validade para o front

{
  "hasError": false,
  "data": {
    "transaction_id": "M4X8C2V6B0N3",
    "total_value": 374,
    "currency": "MXN",
    "status": "PENDING",
    "email": "sofia@exemplo.com",
    "payment_method": "spei",
    "payment_data": {
      "payment_id": "…",
      "status": "PENDING",
      "status_detail": "WAITING_PAYMENT",
      "total_transaction_value": 374,
      "currency": "MXN",
      "amount": 374,
      "exchange_rate": 0.3,
      "spei": {
        "clabe": "012180001234567890",
        "reference": "1234567",
        "bank": null,
        "beneficiary": null,
        "expires_at": "2026-10-09T05:59:00.000Z"
      }
    }
  }
}

// spei, valor: dados que o seu servidor repassou da resposta da API
const valorFormatado = new Intl.NumberFormat("es-MX", { style: "currency", currency: "MXN" }).format(valor);
const validade = spei.expires_at
  ? new Intl.DateTimeFormat("es-MX", {
      dateStyle: "short",
      timeStyle: "short",
      timeZone: "America/Mexico_City",
    }).format(new Date(spei.expires_at))
  : null;

document.querySelector("#clabe").textContent = spei.clabe;
document.querySelector("#copiar-clabe").addEventListener("click", () => navigator.clipboard.writeText(spei.clabe));

function documentoMexicoValido(valor) {
  const doc = valor.toUpperCase().replace(/[\s.-]/g, "");
  const RFC = /^[A-ZÑ&]{3,4}\d{6}[A-Z\d]{3}$/;
  const CURP = /^[A-Z][AEIOUX][A-Z]{2}\d{6}[HMX][A-Z]{2}[B-DF-HJ-NP-TV-Z]{3}[A-Z\d]\d$/;
  return RFC.test(doc) || CURP.test(doc);
}

curl https://api.pagpayze.com.br/api/v1/payments/7KQ2M9XA4T1B/status

const res = await fetch(`https://api.pagpayze.com.br/api/v1/payments/${transactionId}/status`);
const body = await res.json();
if (!res.ok) throw new Error(body.error); // ex.: "Pedido não encontrado!"

console.log(body.data.status); // "PENDING", "AUTHORIZED"…

$url = "https://api.pagpayze.com.br/api/v1/payments/" . urlencode($transactionId) . "/status";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$status = $body["data"]["status"] ?? null; // "PENDING", "AUTHORIZED"…

{
  "hasError": false,
  "data": {
    "transaction_id": "7KQ2M9XA4T1B",
    "total_value": 99.9,
    "fee": 4.49,
    "net_value": 95.41,
    "status": "AUTHORIZED",
    "product": null,
    "payment_method": "PIX",
    "producer": null,
    "payment_data": {
      "pix_key": "00020126580014br.gov.bcb.pix0136…6304A1B2",
      "expiration_date": null,
      "payment_id": "c1a7e0b2-5d3f-4e8a-9b61-0f2d7c4e9a13",
      "status": "PENDING",
      "status_detail": "WAITING_PAYMENT",
      "total_transaction_value": 99.9
    }
  }
}

{
  "hasError": false,
  "data": {
    "transaction_id": "Q8W3E5R7T9Y2",
    "total_value": 99.94,
    "fee": 5.99,
    "net_value": 93.95,
    "status": "PENDING",
    "product": null,
    "payment_method": "BIZUM",
    "producer": null,
    "payment_data": {
      "international": {
        "method": "BIZUM",
        "currency": "EUR",
        "amount": 16.12,
        "brl_amount": 99.94,
        "brl_per_unit": 6.2
      },
      "session": {
        "session_token": "…",
        "public_key": "…",
        "account": null,
        "transaction_id": "…",
        "sdk_url": "https://compra-segura.pagpayze.com.br/sdk/v1/checkout.js",
        "sandbox": false
      }
    }
  }
}

{
  "hasError": false,
  "data": {
    "transaction_id": "M4X8C2V6B0N3",
    "total_value": 112.2,
    "fee": 6.72,
    "net_value": 105.48,
    "status": "PENDING",
    "product": null,
    "payment_method": "SPEI",
    "producer": null,
    "payment_data": {
      "international": {
        "method": "SPEI",
        "currency": "MXN",
        "amount": 374,
        "brl_amount": 112.2,
        "brl_per_unit": 0.3
      },
      "spei": {
        "clabe": "012180001234567890",
        "reference": "1234567",
        "bank": null,
        "beneficiary": null,
        "expires_at": "2026-10-09T05:59:00.000Z"
      }
    }
  }
}

{
  "transaction_id": "7KQ2M9XA4T1B",
  "total_value": 99.9,
  "fee": 4.49,
  "net_value": 95.41,
  "status": "AUTHORIZED",
  "product": null,
  "payment_method": "PIX",
  "producer": null,
  "payment_data": {
    "pix_key": "00020126580014br.gov.bcb.pix0136…6304A1B2",
    "expiration_date": null,
    "payment_id": "c1a7e0b2-5d3f-4e8a-9b61-0f2d7c4e9a13",
    "status": "PENDING",
    "status_detail": "WAITING_PAYMENT",
    "total_transaction_value": 99.9
  },
  "customer": {
    "name": "João da Silva",
    "email": "joao@exemplo.com",
    "document": "12345678909",
    "phone": "+5511999999999",
    "birth_date": "15/01/1990",
    "address": {}
  }
}

import express from "express";

const app = express();
app.use(express.json());

const API = "https://api.pagpayze.com.br/api/v1";

app.post("/webhooks/payze/:token", async (req, res) => {
  if (req.params.token !== process.env.PAYZE_WEBHOOK_TOKEN) return res.sendStatus(404);
  res.sendStatus(200); // responda logo; processe em seguida

  const transactionId = req.body?.transaction_id;
  if (!transactionId) return;

  const pedido = await db.pedidos.porTransacao(transactionId);
  if (!pedido) return; // transação que não é desta integração

  // Confirma o status na fonte antes de agir
  const r = await fetch(`${API}/payments/${transactionId}/status`);
  if (!r.ok) return;
  const { data } = await r.json();

  if (data.status === "AUTHORIZED") {
    const mudou = await db.pedidos.marcarPagoSeAindaNao(pedido.id); // UPDATE condicional
    if (mudou) await liberarPedido(pedido);
  } else if (["REFUNDED", "CHARGEBACK"].includes(data.status)) {
    await revogarPedido(pedido);
  }
});

app.listen(3000);

<?php
// URL cadastrada: https://loja.exemplo.com/webhook-payze.php?token=SEU_TOKEN
if (!hash_equals(getenv("PAYZE_WEBHOOK_TOKEN"), $_GET["token"] ?? "")) {
  http_response_code(404);
  exit;
}

$aviso = json_decode(file_get_contents("php://input"), true);
http_response_code(200);
$transactionId = $aviso["transaction_id"] ?? null;
if (!$transactionId) exit;

// Confirma o status na fonte antes de agir
$ch = curl_init("https://api.pagpayze.com.br/api/v1/payments/" . urlencode($transactionId) . "/status");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$status = json_decode(curl_exec($ch), true)["data"]["status"] ?? null;
curl_close($ch);

if ($status === "AUTHORIZED") {
  // UPDATE pedidos SET status = 'pago' WHERE transaction_id = ? AND status <> 'pago'
  // Se mudou 1 linha, libere o pedido.
}

{
  "hasError": true,
  "error": "Erro na validação dos campos",
  "errorFields": [
    "amount must not be less than 1",
    "customer.email must be an email"
  ],
  "statusCode": 400,
  "timestamp": "2026-10-08T15:19:00.782Z",
  "path": "/api/v1/direct-payments"
}