Endpoint
POST https://api.pagou.ai/v2/transactions
Regras para cartão
| Campo | Obrigatório | Exemplo | Regra |
|---|
method | sim | credit_card | deve ser credit_card |
token | sim no fluxo WebSDK | pgct_0123... | gerado no frontend via WebSDK |
amount | sim | 1500 | valor em centavos |
installments | não | 1 | mínimo 1 |
buyer | sim | { name, email, document } | identificação do comprador |
products | sim | [{ name, price, quantity }] | mínimo 1 item |
Exemplo SDK TypeScript (backend)
const created = await client.transactions.create({
amount: 1500,
currency: "BRL",
method: "credit_card",
token: "pgct_0123456789abcdef",
installments: 1,
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.status);
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": "credit_card",
"token": "pgct_0123456789abcdef",
"installments": 1,
"buyer": {
"name": "Maria Silva",
"email": "maria@empresa.com",
"document": {
"type": "CPF",
"number": "12345678901"
}
},
"products": [
{
"name": "Pedido #1234",
"price": 1500,
"quantity": 1
}
]
}'
Resposta esperada (resumo)
{
"id": "trx_xxx",
"status": "pending",
"amount": 1500,
"method": "credit_card",
"installments": 1
}
Não envie PAN, CVV ou validade para a API. Use apenas o token retornado pelo WebSDK.
Não existe rota pública de tokenização na API. A geração de token deve acontecer no frontend via WebSDK.
