Skip to main content

​
Endpoint

POST https://api.pagou.ai/v2/transactions

​
Campos essenciais para Pix

CampoObrigatórioExemploRegra
amountsim1500centavos (1500 = R$15,00)
currencysimBRLpara Pix, use BRL
methodsimpixdeve ser pix neste fluxo
buyer.namecondicionalMaria Silvaobrigatório quando buyer.id não for enviado
buyer.emailcondicionalmaria@empresa.comobrigatório quando buyer.id não for enviado
buyer.documentrecomendado{ type: "CPF", number: "123..." }ajuda em antifraude e compliance
productssim[{ name, price, quantity }]mínimo 1 item
notify_urlnãohttps://seuapp.com/webhooks/pagouwebhook específico da transação (HTTPS)

​
Exemplo SDK TypeScript

const created = await client.transactions.create({
  amount: 1500,
  currency: "BRL",
  method: "pix",
  notify_url: "https://seuapp.com/webhooks/pagou",
  buyer: {
    name: "Maria Silva",
    email: "maria@empresa.com",
    document: {
      type: "CPF",
      number: "12345678901",
    },
  },
  products: [{ name: "Pedido #1234", price: 1500, quantity: 1 }],
});

console.log(created.data.id, created.data.pix?.qr_code);

​
Exemplo HTTP (cURL)

curl --request POST \
  --url https://api.pagou.ai/v2/transactions \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer SEU_TOKEN" \
  --data '{
    "amount": 1500,
    "currency": "BRL",
    "method": "pix",
    "notify_url": "https://example-webhook.myapp.dev/transactions",
    "buyer": {
      "name": "Maria Silva",
      "email": "maria@empresa.com",
      "document": {
        "type": "CPF",
        "number": "12345678901"
      },
      "address": {
        "street": "Rua Exemplo",
        "city": "Sao Paulo",
        "country": "BR"
      }
    },
    "products": [
      {
        "name": "Pedido #1234",
        "price": 1500,
        "quantity": 1
      }
    ]
  }'

​
Resposta esperada (resumo)

{
  "id": "trx_xxx",
  "status": "pending",
  "amount": 1500,
  "method": "pix",
  "pix": {
    "qr_code": "000201...",
    "expiration_date": "2026-02-25T19:00:00.000Z"
  }
}