Criar transação
POST /v1/transactions - Criar uma nova transação PIX, cartão ou boleto.
Cria uma nova transação. Suporta os métodos de pagamento pix, card e boleto.
Atenção: enviar duas requisições com o mesmo
external_idpara o mesmo vendedor retorna 400 comtransaction_already_exists. Oexternal_iddeve ser único por vendedor.
Sobre o campo
offer.slug: o slug está disponível no painel da Buck, na página de cada oferta. Informá-lo vincula a transação à oferta real do seu catálogo, o que é necessário para que automações de venda sejam disparadas corretamente.
Authorization
bearerAuth Envie o token no header Authorization, no formato Bearer <token>.
O <token> é um secret de 40 caracteres fornecido pela BuckPay — solicite suas
credenciais ao seu gerente de contas. Detalhes e erros de autenticação em
Autenticação.
In: header
Header Parameters
Valor fornecido pelo seu gerente de contas. Sem o User-Agent correto,
a requisição pode falhar. Ver Autenticação.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/transactions" \ -H "User-Agent: string" \ -H "Content-Type: application/json" \ -d '{ "external_id": "uuuid7364239uhioubn", "payment_method": "pix", "amount": 3590, "buyer": { "name": "João Silva", "email": "joao@email.com", "document": "10233019111", "phone": "5561999134129" }, "product": { "name": "Produto Exemplo" }, "offer": { "slug": "makita" }, "tracking": { "ref": null, "src": null, "sck": null, "utm_source": null, "utm_medium": null, "utm_campaign": null, "utm_id": null, "utm_term": null, "utm_content": null } }'{ "data": { "id": "390b5525-4629-4463-a32a-e0cd432d939b", "status": "pending", "payment_method": "pix", "pix": { "code": "00020126870014br.gov.bcb.pix...", "qrcode_base64": "iVBORw0KGgo..." }, "total_amount": 3590, "net_amount": 3195.959, "created_at": "2025-05-24T17:45:19.084Z" }}